| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257 |
- """Setup-completion summary (tool availability + "Setup Complete!" banner). setup.py names are
- resolved through the module object so test patches on ``hermes_cli.setup.<name>`` take effect."""
- import logging
- from tools import tool_backend_helpers
- from hermes_cli import nous_subscription
- logger = logging.getLogger("hermes_cli.setup")
- # provider -> (label, env vars: any one set means available; empty = always).
- # Local engines are (label, module, hint) and must be importable.
- _TTS_SUMMARY_ROWS = {
- "elevenlabs": ("ElevenLabs", ("ELEVENLABS_API_KEY",)),
- "openai": ("OpenAI", ("VOICE_TOOLS_OPENAI_KEY", "OPENAI_API_KEY")),
- "minimax": ("MiniMax", ("MINIMAX_API_KEY",)), "mistral": ("Mistral Voxtral", ("MISTRAL_API_KEY",)),
- "gemini": ("Google Gemini", ("GEMINI_API_KEY", "GOOGLE_API_KEY")),
- "neutts": ("NeuTTS", "neutts", "run 'hermes setup tts'"),
- "kittentts": ("KittenTTS", "kittentts", "run 'hermes setup tts'")}
- _TTS_SUMMARY_DEFAULT = ("Edge TTS", ())
- _STT_SUMMARY_ROWS = {
- "openai": ("OpenAI", ("VOICE_TOOLS_OPENAI_KEY", "OPENAI_API_KEY")), "groq": ("Groq Whisper", ("GROQ_API_KEY",)),
- "elevenlabs": ("ElevenLabs Scribe", ("ELEVENLABS_API_KEY",)), "xai": ("xAI", ()),
- "deepinfra": ("DeepInfra", ("DEEPINFRA_API_KEY",))}
- _STT_SUMMARY_DEFAULT = ("Local Whisper", "faster_whisper", "run 'hermes tools' → Speech-to-Text")
- # Browser "missing" hint keyed by the configured provider; anything else gets the generic hint.
- _BROWSER_MISSING_HINTS = {
- "Browserbase": "BROWSERBASE_API_KEY/BROWSERBASE_PROJECT_ID",
- "Browser Use": "BROWSER_USE_API_KEY",
- "Local browser": "Chromium: run 'hermes pm install chromium'"}
- _BROWSER_MISSING_DEFAULT = "Chromium (run 'hermes pm install chromium'), or configure Browser Use or Browserbase"
- _WEB_MISSING = ("EXA_API_KEY, PARALLEL_API_KEY, FIRECRAWL_API_KEY/FIRECRAWL_API_URL, TAVILY_API_KEY, "
- "PERPLEXITY_API_KEY, KEENABLE_API_KEY, or SEARXNG_URL")
- _DONE_BANNER = (
- "┌─────────────────────────────────────────────────────────┐",
- "│ ✓ Setup Complete! │",
- "└─────────────────────────────────────────────────────────┘")
- # (command, description) rows; the description carries its own alignment padding.
- _EDIT_WIZARD_ROWS = (
- ("hermes setup", " Re-run the full wizard"), ("hermes setup model", " Change model/provider"),
- ("hermes setup terminal", " Change terminal backend"), ("hermes setup gateway", " Configure messaging"),
- ("hermes setup tools", " Configure tool providers"))
- _EDIT_CONFIG_ROWS = (
- ("hermes config", " View current settings"), ("hermes config edit", " Open config in your editor"),
- ("hermes config set <key> <value>", ""))
- _READY_ROWS = (
- ("hermes", " Start chatting"), ("hermes gateway", " Start messaging gateway"),
- ("hermes doctor", " Check for issues"))
- def _voice_provider_status(kind: str, provider: str, rows: dict, default: tuple) -> tuple:
- """Summary row for a TTS/STT provider. A keyed provider whose key is missing
- falls through to the default row, matching the runtime fallback."""
- row = rows.get(provider, default)
- if isinstance(row[1], tuple) and row[1] and not any(_setup.get_env_value(v) for v in row[1]):
- row = default
- if isinstance(row[1], tuple):
- return (f"{kind} ({row[0]})", True, None)
- label, module, hint = row
- if _setup._module_installed(module):
- return (f"{kind} ({label}{' local' if kind == 'Text-to-Speech' else ''})", True, None)
- return (f"{kind} ({label} — not installed)", False, hint)
- def _first_available_plugin_provider(registry: str, skip: str | None = None):
- """display_name of the first plugin-registered provider in ``agent.<registry>`` that reports
- available (fail-soft: any error means none), skipping ``skip``."""
- try:
- import importlib
- from hermes_cli.plugins import _ensure_plugins_discovered
- _ensure_plugins_discovered()
- for provider in importlib.import_module(f"agent.{registry}").list_providers():
- if provider.name == skip:
- continue
- try:
- if provider.is_available():
- return provider.display_name
- except Exception:
- continue
- except Exception:
- pass
- return None
- # ---- tool_status row builders: each takes (config, subscription_features) and returns
- # a (name, available, hint) row or None (row omitted). Evaluated in _TOOL_ROW_BUILDERS order.
- def _vision_row(config, feats):
- # Use the same runtime resolver as the actual vision tools.
- try:
- from agent.auxiliary_client import get_available_vision_backends
- ok = bool(get_available_vision_backends())
- except Exception:
- ok = False
- return ("Vision (image analysis)", ok, None if ok else "run 'hermes setup' to configure")
- def _managed_or_provider_row(feature, name: str, managed_label: str, missing_hint: str):
- """Row for a Nous-manageable feature: managed > available (with provider) > missing hint."""
- if feature.managed_by_nous:
- return (f"{name} ({managed_label})", True, None)
- if feature.available:
- return (f"{name} ({feature.current_provider})" if feature.current_provider else name, True, None)
- return (name, False, missing_hint)
- def _web_row(config, feats):
- # Web tools (Exa, Parallel, Firecrawl, Tavily, or Keenable)
- return _managed_or_provider_row(feats.web, "Web Search & Extract", "Nous subscription", _WEB_MISSING)
- def _browser_row(config, feats):
- # Browser tools (local Chromium, Lightpanda, Browserbase, Browser Use, or Firecrawl)
- hint = _BROWSER_MISSING_HINTS.get(feats.browser.current_provider, _BROWSER_MISSING_DEFAULT)
- return _managed_or_provider_row(feats.browser, "Browser Automation", "Nous Browser Use", hint)
- def _image_gen_row(config, feats):
- # FAL (direct or via Nous), or any plugin-registered provider (OpenAI, etc.)
- if feats.image_gen.managed_by_nous:
- return ("Image Generation (Nous subscription)", True, None)
- if feats.image_gen.available:
- return ("Image Generation", True, None)
- # Probe plugin-registered providers so OpenAI-only setups don't show as "missing FAL_KEY".
- backend = _first_available_plugin_provider("image_gen_registry", skip="fal")
- if backend:
- return (f"Image Generation ({backend})", True, None)
- return ("Image Generation", False, "FAL_KEY or OPENAI_API_KEY")
- def _video_gen_row(config, feats):
- # Opt-in via `hermes tools` → Video Generation. Only show the row when a plugin reports
- # available so we don't badger users who don't care about video gen with a "missing" line.
- if feats.video_gen.managed_by_nous:
- return ("Video Generation (FAL via Nous subscription)", True, None)
- backend = _first_available_plugin_provider("video_gen_registry")
- return (f"Video Generation ({backend})", True, None) if backend else None
- def _tts_row(config, feats):
- # Configured provider, gated on its key (or local install)
- if feats.tts.managed_by_nous:
- return ("Text-to-Speech (OpenAI via Nous subscription)", True, None)
- provider = _setup.cfg_get(config, "tts", "provider", default="edge")
- return _voice_provider_status("Text-to-Speech", provider, _TTS_SUMMARY_ROWS, _TTS_SUMMARY_DEFAULT)
- def _stt_row(config, feats):
- stt_feature = feats.features.get("stt")
- if stt_feature is not None and stt_feature.managed_by_nous:
- return ("Speech-to-Text (OpenAI via Nous subscription)", True, None)
- provider = _setup.cfg_get(config, "stt", "provider", default="local") or "local"
- return _voice_provider_status("Speech-to-Text", provider, _STT_SUMMARY_ROWS, _STT_SUMMARY_DEFAULT)
- def _modal_row(config, feats):
- if feats.modal.managed_by_nous:
- return ("Modal Execution (Nous subscription)", True, None)
- if _setup.cfg_get(config, "terminal", "backend") == "modal":
- if feats.modal.direct_override:
- return ("Modal Execution (direct Modal)", True, None)
- return ("Modal Execution", False, "run 'hermes setup terminal'")
- if tool_backend_helpers.managed_nous_tools_enabled() and feats.nous_auth_present:
- return ("Modal Execution (optional via Nous subscription)", True, None)
- return None
- def _skills_hub_row(config, feats):
- ok = bool(_setup.get_env_value("GITHUB_TOKEN"))
- return ("Skills Hub (GitHub)", ok, None if ok else "GITHUB_TOKEN")
- def _always_on_rows(config, feats):
- # Terminal (system deps met), task planning (in-memory), skills (bundled + user-created).
- return [("Terminal/Commands", True, None), ("Task Planning (todo)", True, None),
- ("Skills (view, create, edit)", True, None)]
- _TOOL_ROW_BUILDERS = (
- _vision_row, _web_row, _browser_row, _image_gen_row, _video_gen_row, _tts_row, _stt_row,
- _modal_row, _skills_hub_row, _always_on_rows)
- def _print_cmd_rows(rows):
- """Print (command, description) rows as ' <green cmd><desc>'."""
- for cmd, desc in rows:
- print(f" {_setup.color(cmd, _setup.Colors.GREEN)}{desc}")
- def _print_section_header(title):
- print(_setup.color("─" * 60, _setup.Colors.DIM), end="\n\n")
- print(_setup.color(title, _setup.Colors.CYAN, _setup.Colors.BOLD), end="\n\n")
- def _print_setup_summary(config: dict, hermes_home):
- """Print the setup completion summary."""
- from hermes_constants import display_hermes_home as _dhh
- # Provider readiness — the one thing setup must produce. A user who cancelled the API-key
- # prompt mid-wizard used to exit "successfully" with NO working model; say so loudly.
- try:
- from hermes_cli.auth import resolve_provider
- resolve_provider()
- except Exception:
- print()
- _setup.print_warning("No inference provider is configured — Hermes cannot chat yet.")
- _setup._info(" Finish this one step with either of:",
- " hermes model (pick any provider/model)",
- " hermes setup --portal (Nous Portal OAuth, no API key)")
- print()
- _setup.print_header("Tool Availability Summary")
- tool_status = []
- subscription_features = nous_subscription.get_nous_subscription_features(config)
- for build in _TOOL_ROW_BUILDERS:
- row = build(config, subscription_features)
- tool_status.extend(row if isinstance(row, list) else [] if row is None else [row])
- available_count = sum(1 for _, avail, _ in tool_status if avail)
- _setup._info(f"{available_count}/{len(tool_status)} tool categories available:", None)
- for name, available, missing_var in tool_status:
- print(f" {_setup.color('✓', _setup.Colors.GREEN)} {name}" if available else
- f" {_setup.color('✗', _setup.Colors.RED)} {name} "
- f"{_setup.color(f'(missing {missing_var})', _setup.Colors.DIM)}")
- print()
- if available_count < len(tool_status):
- _setup.print_warning("Some tools are disabled. Run 'hermes setup tools' to configure them,")
- _setup.print_warning(f"or edit {_dhh()}/.env directly to add the missing API keys.")
- print()
- print()
- for line in _DONE_BANNER:
- print(_setup.color(line, _setup.Colors.GREEN))
- print()
- print(_setup.color(f"📁 All your files are in {_dhh()}/:", _setup.Colors.CYAN, _setup.Colors.BOLD), end="\n\n")
- for label, value in (("Settings:", f" {_setup.get_config_path()}"), ("API Keys:", f" {_setup.get_env_path()}"),
- ("Data:", f" {hermes_home}/cron/, sessions/, logs/")):
- print(f" {_setup.color(label, _setup.Colors.YELLOW)}{value}")
- print()
- _print_section_header("📝 To edit your configuration:")
- _print_cmd_rows(_EDIT_WIZARD_ROWS)
- print()
- _print_cmd_rows(_EDIT_CONFIG_ROWS)
- print(" Set a specific value\n\n Or edit the files directly:")
- for path in (_setup.get_config_path(), _setup.get_env_path()):
- print(f" {_setup.color(f'nano {path}', _setup.Colors.DIM)}")
- print()
- _print_section_header("🚀 Ready to go!")
- _print_cmd_rows(_READY_ROWS)
- print()
- import hermes_cli.setup as _setup
|