| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115 |
- """CLI handlers for the ``hermes proxy`` subcommand."""
- from __future__ import annotations
- import asyncio
- import logging
- import sys
- from typing import Any
- from hermes_cli.proxy.adapters import ADAPTERS, get_adapter
- from hermes_cli.proxy.server import (
- AIOHTTP_AVAILABLE, DEFAULT_HOST, DEFAULT_PORT, run_server
- )
- logger = logging.getLogger(__name__)
- def _err(msg: str) -> None:
- print(msg, file=sys.stderr)
- def cmd_proxy_start(args: Any) -> int:
- """Run the proxy server in the foreground."""
- if not AIOHTTP_AVAILABLE:
- _err("hermes proxy requires aiohttp. Run `hermes setup` to install it.")
- return 1
- provider = getattr(args, "provider", None) or "nous"
- try:
- adapter = get_adapter(provider)
- except ValueError as exc:
- _err(f"Error: {exc}")
- return 2
- if not adapter.is_authenticated():
- auth_hint = getattr(adapter, "auth_hint", f"hermes auth add {adapter.name}")
- _err(f"Not logged into {adapter.display_name}. Run `{auth_hint}` first.")
- return 2
- from hermes_cli.url_utils import format_url_host
- host = getattr(args, "host", None) or DEFAULT_HOST
- port = getattr(args, "port", None) or DEFAULT_PORT
- _err(
- f"Starting Hermes proxy for {adapter.display_name}\n"
- f" Listening on: http://{format_url_host(host)}:{port}/v1\n"
- f" Forwarding to: (resolved per-request from your subscription)\n"
- f" Use any bearer token in the client — the proxy attaches your real credential.\n"
- f"\n"
- f"Press Ctrl+C to stop."
- )
- try:
- asyncio.run(run_server(adapter, host=host, port=port))
- except KeyboardInterrupt:
- _err("\nproxy: stopped")
- except OSError as exc:
- _err(f"proxy: failed to bind {host}:{port}: {exc}")
- return 1
- return 0
- def cmd_proxy_status(args: Any) -> int:
- """Print the status of each configured upstream adapter."""
- print("Hermes proxy upstream adapters\n")
- for name in sorted(ADAPTERS):
- adapter = get_adapter(name)
- if not adapter.is_authenticated():
- print(f" [{name:8s}] {adapter.display_name} — not logged in")
- continue
- try:
- cred = adapter.get_credential()
- except Exception as exc:
- print(f" [{name:8s}] {adapter.display_name} — credentials need attention ({exc})")
- continue
- expires = f" (bearer expires {cred.expires_at})" if cred.expires_at else ""
- print(f" [{name:8s}] {adapter.display_name} — ready{expires}")
- print("\nStart the proxy with: hermes proxy start [--provider <name>]")
- return 0
- def cmd_proxy_list_providers(args: Any) -> int:
- """List available proxy upstream providers."""
- print("Available proxy upstream providers:")
- for name in sorted(ADAPTERS):
- adapter = get_adapter(name)
- print(f" {name} — {adapter.display_name}")
- return 0
- _SUBCOMMANDS = {
- "start": cmd_proxy_start,
- "status": cmd_proxy_status,
- "providers": cmd_proxy_list_providers,
- "list": cmd_proxy_list_providers,
- }
- def cmd_proxy(args: Any) -> int:
- """Dispatch ``hermes proxy <subcommand>``; no/unknown subcommand prints the short help."""
- handler = _SUBCOMMANDS.get(getattr(args, "proxy_command", None))
- if handler is not None:
- return handler(args)
- _err(
- "hermes proxy — local OpenAI-compatible proxy that attaches your\n"
- "OAuth-authenticated provider credentials to outbound requests.\n"
- "\n"
- "Subcommands:\n"
- " hermes proxy start [--provider nous|xai] [--host 127.0.0.1] [--port 8645]\n"
- " Run the proxy in the foreground.\n"
- " hermes proxy status\n"
- " Show which upstream adapters are ready.\n"
- " hermes proxy providers\n"
- " List available upstream providers.\n"
- )
- return 0
- __all__ = ["cmd_proxy", "cmd_proxy_list_providers", "cmd_proxy_start", "cmd_proxy_status"]
|