☤ Hermes HUD — Web UI

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.

Quick Start

git clone https://github.com/joeynyc/hermes-hudui.git
cd hermes-hudui
./install.sh
hermes-hudui

Open http://localhost:3001

Requirements: Python 3.11+, Node.js 18+, a running Hermes agent with data in ~/.hermes/

On future runs:

source venv/bin/activate && hermes-hudui

What's Inside

13 tabs covering everything your agent knows about itself — identity, memory, skills, sessions, cron jobs, projects, health, costs, patterns, corrections, and live chat.

Updates in real-time via WebSocket. No manual refresh needed.

Language Support

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.

Themes

Four themes switchable with t: Neural Awakening (cyan), Blade Runner (amber), fsociety (green), Anime (purple). Optional CRT scanlines.

Keyboard Shortcuts

Key	Action
1–9, 0	Switch tabs
t	Theme picker
Ctrl+K	Command palette

Relationship to the TUI

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, and Sessions tabs; per-model token cost tracking; command palette; live chat; theme switcher.

If you also have the TUI installed, you can enable it with pip install hermes-hudui[tui].

Platform Support

macOS · Linux · WSL

License

MIT — see LICENSE.

---