mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-07-10 13:31:38 +00:00
2bd9c9b881
hermes --tui launches the native OpenTUI engine (Bun) when HERMES_TUI_ENGINE=opentui (env) or display.tui_engine=opentui (config); Ink stays the default and the shipping path is untouched. - _resolve_tui_engine() (env > config > ink); refuses opentui on Windows/Termux (no Bun) -> falls back to ink with a notice. - _make_opentui_argv() -> [bun, src/entry.real.tsx] (no build step). - _bun_bin() with HERMES_BUN override. - Branch at top of _make_tui_argv BEFORE _ensure_tui_node (Bun-only host must not bootstrap Node). - Gate _launch_tui NODE_OPTIONS/--max-old-space-size on engine==ink (Bun is JSC; the V8 flag errors/ignores). Verified end-to-end via tmux: real hermes --tui -> Bun -> OpenTUI -> real Python gateway streamed a real reply. No-flag default still ink.
123 lines
5.3 KiB
Python
123 lines
5.3 KiB
Python
"""``hermes dashboard`` subcommand parser.
|
|
|
|
Extracted verbatim from ``hermes_cli/main.py:main()`` (god-file Phase 2).
|
|
Handler injected to avoid importing ``main``.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
from typing import Callable
|
|
|
|
|
|
def build_dashboard_parser(
|
|
subparsers, *, cmd_dashboard: Callable, cmd_dashboard_register: Callable
|
|
) -> None:
|
|
"""Attach the ``dashboard`` subcommand (and its ``register`` action)."""
|
|
# =========================================================================
|
|
# dashboard command
|
|
# =========================================================================
|
|
dashboard_parser = subparsers.add_parser(
|
|
"dashboard",
|
|
help="Start the web UI dashboard",
|
|
description="Launch the Hermes Agent web dashboard for managing config, API keys, and sessions",
|
|
)
|
|
dashboard_parser.add_argument(
|
|
"--port", type=int, default=9119, help="Port (default 9119)"
|
|
)
|
|
dashboard_parser.add_argument(
|
|
"--host", default="127.0.0.1", help="Host (default 127.0.0.1)"
|
|
)
|
|
dashboard_parser.add_argument(
|
|
"--no-open", action="store_true", help="Don't open browser automatically"
|
|
)
|
|
dashboard_parser.add_argument(
|
|
"--insecure",
|
|
action="store_true",
|
|
help="Allow binding to non-localhost (DANGEROUS: exposes API keys on the network)",
|
|
)
|
|
dashboard_parser.add_argument(
|
|
"--skip-build",
|
|
action="store_true",
|
|
help=(
|
|
"Skip the web UI build step and serve the existing dist directly. "
|
|
"Useful for non-interactive contexts (Windows Scheduled Tasks, CI) "
|
|
"where npm may not be available. Pre-build with: cd web && npm run build"
|
|
),
|
|
)
|
|
# Lifecycle flags — mutually exclusive with each other and with the
|
|
# start-a-server flags above (if both are passed, --stop / --status win
|
|
# because they exit before the server is started). The dashboard has
|
|
# no service manager and no PID file, so these scan the process table
|
|
# for `hermes dashboard` cmdlines and SIGTERM them directly — the same
|
|
# path `hermes update` uses to clean up stale dashboards.
|
|
dashboard_parser.add_argument(
|
|
"--stop",
|
|
action="store_true",
|
|
help="Stop all running hermes dashboard processes and exit",
|
|
)
|
|
dashboard_parser.add_argument(
|
|
"--status",
|
|
action="store_true",
|
|
help="List running hermes dashboard processes and exit",
|
|
)
|
|
# Backward-compat shim: older Hermes desktop app shells (<= 0.15.x) spawn the
|
|
# backend as `hermes dashboard --no-open --tui --host ... --port ...`. The
|
|
# `--tui` flag was removed from this subcommand in cae6b5486 (embedded chat is
|
|
# always on now). When a user's CLI updates past that commit but their desktop
|
|
# app binary has not, argparse used to hard-error with "unrecognized arguments:
|
|
# --tui" and exit(2) — the backend died before becoming ready and the GUI just
|
|
# showed "Hermes couldn't start" with no actionable cause. Accept and silently
|
|
# ignore the flag so an old app + new CLI degrades gracefully instead of
|
|
# bricking. Hidden from --help; safe to delete once the floor app version is
|
|
# well past 0.16.0.
|
|
dashboard_parser.add_argument(
|
|
"--tui",
|
|
action="store_true",
|
|
help=argparse.SUPPRESS,
|
|
)
|
|
dashboard_parser.set_defaults(func=cmd_dashboard)
|
|
|
|
# `hermes dashboard register` — register a self-hosted dashboard OAuth
|
|
# client with Nous Portal and write the client_id into ~/.hermes/.env.
|
|
# Nested subparser so bare `hermes dashboard` keeps launching the server
|
|
# (set_defaults(func=cmd_dashboard) above remains the default).
|
|
dashboard_subparsers = dashboard_parser.add_subparsers(
|
|
dest="dashboard_subcommand"
|
|
)
|
|
dashboard_register_parser = dashboard_subparsers.add_parser(
|
|
"register",
|
|
help="Register a self-hosted dashboard with Nous Portal (writes the OAuth client ID to .env)",
|
|
description=(
|
|
"Register this install as a self-hosted dashboard with your Nous "
|
|
"Portal account. Creates an OAuth client, writes "
|
|
"HERMES_DASHBOARD_OAUTH_CLIENT_ID into ~/.hermes/.env, and prints "
|
|
"how to engage the login gate. Requires being logged in (hermes setup)."
|
|
),
|
|
)
|
|
dashboard_register_parser.add_argument(
|
|
"--name",
|
|
default=None,
|
|
help="Human-readable label for the dashboard (default: an auto-generated name)",
|
|
)
|
|
dashboard_register_parser.add_argument(
|
|
"--redirect-uri",
|
|
dest="redirect_uri",
|
|
default=None,
|
|
help=(
|
|
"Optional public HTTPS OAuth redirect URI for the dashboard, e.g. "
|
|
"https://hermes.example.com/auth/callback. Omit for localhost-only use."
|
|
),
|
|
)
|
|
dashboard_register_parser.add_argument(
|
|
"--portal-url",
|
|
dest="portal_url",
|
|
default=None,
|
|
help=(
|
|
"Override the Nous Portal base URL for registration (default: the "
|
|
"portal you logged into). The access token must be valid at this "
|
|
"portal. Also settable via HERMES_DASHBOARD_PORTAL_URL. Mainly for "
|
|
"testing against a staging/preview portal."
|
|
),
|
|
)
|
|
dashboard_register_parser.set_defaults(func=cmd_dashboard_register)
|