emozilla
43e67d872f
Run models locally as a first-class provider. The CLI grows a managed llama.cpp runtime (engine install, model download, server supervision); the desktop app grows the full setup and management story on top of it. GUI surfaces ship behind the desktop --local launch flag (hermes desktop --local, or the flag on the packaged app); backend routes and the CLI are always live. Runtime (hermes_cli/local_runtime/): - curated GGUF catalog with per-machine variant selection: hardware probe (VRAM/RAM/UMA), fit planning with spill accounting, quant choice by context window - derived recommendation: quality-ranked picks gated by a predicted decode-speed floor, bandwidth-aware on unified memory; the decision table is pinned as a test (pick AND reason per memory class), and the Recommended badge explains its pick in a tooltip fed by the resolver's actual branch - engine install + model download with resumable split parts, cumulative plan-level progress, and staged-model integrity (a split GGUF counts only when every part is present) - server supervision: spawn/adopt/stop, router mode with per-model load progress relayed over SSE, abandoned-request cleanup Desktop: - Settings -> Providers -> Local models: one-click quickstart (install engine, download the recommended model, boot) plus per-model download/ activate/eject, fit-ranked catalog with context pills - model pickers (composer dropdown + Cmd+K) show staged local models, in-flight downloads as live progress rows, and load-into-memory bars - local-setup campaign tip for eligible hardware; System resources statusbar widget (GPU/VRAM/RAM); in-chat load progress during sends - friendly dead-server errors, and failed agent builds retry on the next send instead of wedging the session Co-developed with NVIDIA field feedback on RTX 5090 and DGX Spark.
86 lines
3.1 KiB
Python
86 lines
3.1 KiB
Python
"""``hermes gui`` subcommand parser.
|
|
|
|
Extracted verbatim from ``hermes_cli/main.py:main()`` (god-file Phase 2).
|
|
Handler injected to avoid importing ``main``.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Callable
|
|
|
|
|
|
def build_gui_parser(subparsers, *, cmd_gui: Callable) -> None:
|
|
"""Attach the ``gui`` subcommand to ``subparsers``."""
|
|
# =========================================================================
|
|
gui_parser = subparsers.add_parser(
|
|
"desktop",
|
|
aliases=["gui"],
|
|
help="Build and launch the native desktop app",
|
|
description=(
|
|
"Launch the Hermes Electron desktop app. By default this installs "
|
|
"workspace Node dependencies, builds the current OS's unpacked "
|
|
"Electron app, then launches that packaged artifact."
|
|
),
|
|
)
|
|
gui_parser.add_argument(
|
|
"--source",
|
|
action="store_true",
|
|
help="Launch via `electron .` against apps/desktop/dist instead of the packaged app",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--build-only",
|
|
action="store_true",
|
|
help="Build the desktop app but do not launch it (used by the installer's --update flow)",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--fake-boot",
|
|
action="store_true",
|
|
help="Enable deterministic desktop boot delays for validating startup UI",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--ignore-existing",
|
|
action="store_true",
|
|
help="Force Desktop to ignore any hermes CLI already on PATH during backend resolution",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--hermes-root",
|
|
help="Override the Hermes source root used by Desktop (sets HERMES_DESKTOP_HERMES_ROOT)",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--cwd",
|
|
help="Initial project directory for Desktop chat sessions (sets HERMES_DESKTOP_CWD)",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--skip-build",
|
|
action="store_true",
|
|
help="Skip npm install/package and launch the existing unpacked app from apps/desktop/release",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--local",
|
|
action="store_true",
|
|
help="Show the local-models UI in the desktop app (models pane, quickstart, picker rows)",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--force-build",
|
|
action="store_true",
|
|
help="Force a full rebuild even if the content stamp matches",
|
|
)
|
|
gui_parser.add_argument(
|
|
"--setup-tcc-identity",
|
|
action="store_true",
|
|
help=(
|
|
"macOS only: create/import a self-signed code-signing certificate "
|
|
"in the login keychain and point desktop.macos_signing_identity at "
|
|
"it, then re-sign the packaged app. Makes macOS TCC grants (Full "
|
|
"Disk Access, Accessibility, Files and Folders, microphone) survive "
|
|
"rebuilds with a certificate-anchored identity. Idempotent — safe "
|
|
"to re-run after updates."
|
|
),
|
|
)
|
|
gui_parser.add_argument(
|
|
"--identity",
|
|
default="Hermes Local Signing",
|
|
help="Certificate name to create/use for --setup-tcc-identity (default: Hermes Local Signing)",
|
|
)
|
|
gui_parser.set_defaults(func=cmd_gui)
|