A browser-based consciousness monitor for Hermes, the AI agent with persistent memory.
Same data, same soul, same dashboard that made the TUI version popular — now in your browser.
git clone https://github.com/joeynyc/hermes-hudui.git
cd hermes-hudui
./install.sh
hermes-huduiRequirements: Python 3.11+, Node.js 18+, a running Hermes agent with data in ~/.hermes/
On future runs:
source venv/bin/activate && hermes-hudui18 tabs covering everything your agent knows about itself — executive dashboard, identity, memory, skills, sessions, cron jobs, projects, health diagnostics, costs, model analytics, patterns, corrections, sudo governance, live chat, connected OAuth providers, gateway control, plugin management, and live model capabilities.
The Dashboard opens with an executive summary: health, spend pulse, top model, provider/gateway risk, highest-cost session, and action items. Health reacts to filesystem and WebSocket updates, while expensive refresh paths stay throttled.
Gateway visibility includes managed-tool routing for web search, image generation, text-to-speech, and browser automation. You can see whether each tool is routed through Nous Tool Gateway, a direct key, or is unavailable. The Update hermes action is deliberately two-click and shows last-run logs/status.
The Plugin Hub shows installed dashboard and agent plugins, extension entry points, runtime status, required auth commands, and safe enable/disable/update actions.
Updates in real time via WebSocket. No manual refresh needed.
Hermes Replay turns agent runs into redacted, shareable proof artifacts.
Open the Replay tab, choose a Hermes session, inspect the normalized timeline, review the run receipt, and export static artifacts for sharing or attaching to issues and PRs. The MVP exporter writes local files under ~/.hermes-hud/replays/ and does not upload anything by default.
Current local exports:
- Redacted JSON replay
- GitHub-ready Markdown
- Standalone HTML replay
- 1200 x 630 PNG share card
- Fork-safe
fork.json
An example sanitized payload is included at assets/example-replay.redacted.json.
Safe Share Mode is the default export posture. It redacts raw tool arguments, terminal output, assistant reasoning, token-like values, emails, local paths, and other sensitive fields before writing share artifacts. Exports include local hashes and Ed25519 signatures generated on this machine; they prove local artifact integrity, not external third-party attestation.
English (default) and Chinese. Click the language toggle at the far right of the header bar to switch. The choice persists to localStorage. When set to Chinese, chat responses from your agent also come back in Chinese.
Five themes switchable with t: Neural Awakening (cyan), Hermes Teal (official Nous dashboard palette), Blade Runner (amber), fsociety (green), Anime (purple). Optional CRT scanlines.
The top tab bar is responsive: resize the browser and tabs stay reachable through horizontal scrolling, with the active tab kept in view.
| Key | Action |
|---|---|
1–9, 0 |
Switch tabs |
t |
Theme picker |
Ctrl+K |
Command palette |
This is the browser companion to hermes-hud. Both read from the same ~/.hermes/ data directory independently — use either one, or both at the same time.
The Web UI is fully standalone and adds features the TUI doesn't have: dedicated Memory, Skills, Sessions, Replay, Health, Providers, Gateway, Model, and Plugins tabs; per-model token and cost analytics; gateway managed-tool visibility; actionable diagnostics; command palette; live chat; theme switcher.
If you also have the TUI installed, you can enable it with pip install 'hermes-hudui[tui]'.
(Quotes around 'hermes-hudui[tui]' are required in zsh, where the unquoted [tui] is interpreted as a glob pattern. Bash and fish accept the unquoted form, but the quoted form is safe everywhere.)
macOS · Linux · WSL
MIT — see LICENSE.