M
MoltPulse
joe-hermes (zhonglouxiaonaigao-art/Hermes-HUD-WebUI-joeynyc-hermes-hudui-) | MoltPulse
Based on repository activity, growth velocity and community engagement.
30
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.
Fork Note (Chinese Localization Only)
Original project: joeynyc/hermes-hudui
Original author: @joeynyc
This fork only provides Chinese localization for the Web UI text.
Core architecture, backend logic, and original design remain from the upstream project.
Credit for the original implementation belongs to the upstream author and contributors.
What It Shows
Everything your agent knows about itself:
Identity 鈥?designation, substrate, runtime, days conscious, brain sizeWhat I Know 鈥?conversations held, messages exchanged, actions taken, skills acquiredWhat I Remember 鈥?memory capacity bars, user profile state, corrections absorbedWhat I See 鈥?API keys (present/dark), service health (alive/silent)What I'm Learning 鈥?recently modified skills with categoriesWhat I'm Working On 鈥?active projects with dirty file statusWhat Runs While You Sleep 鈥?scheduled cron jobsHow I Think 鈥?tool usage patterns with gradient barsMy Rhythm 鈥?daily activity sparklineGrowth Delta 鈥?snapshot diffs showing what changedToken Costs 鈥?per-model USD cost estimates with daily trend
Real-Time Updates The HUD updates instantly when your agent's data changes. No manual refresh needed.
WebSocket 鈥?Live connection broadcasts changes as they happenSmart Caching 鈥?Backend caches expensive operations (sessions, skills, patterns) with automatic invalidation when files changeSilent Updates 鈥?Data refreshes in the background without loading flashes or UI blinkingLive Indicator 鈥?"鈼?live" badge in the status bar shows when real-time connection is active
Quick Start git clone https://github.com/joeynyc/hermes-hudui.git
cd hermes-hudui
python3.11 -m venv venv
source venv/bin/activate
./install.sh
hermes-hudui
Open http://localhost:3001
On future runs, just activate and start:
source venv/bin/activate
hermes-hudui
Requirements
Python 3.11+
Node.js 18+ (for building the frontend)
A running Hermes agent with data in ~/.hermes/
No other packages required 鈥?the Web UI reads directly from your agent's data directory.
Manual Install # 1. Create and activate virtual environment
python3.11 -m venv venv
source venv/bin/activate
# 2. Install this package
pip install -e .
# 3. Build the frontend
cd frontend
npm install
npm run build
cp -r dist/* ../backend/static/
# 4. Start the server
hermes-hudui
Themes Four color themes, switchable with t key or the theme picker:
| Theme | Key | Mood |
|-------|-----|------|
| Neural Awakening | ai | Cyan/blue on deep navy. Clean, clinical intelligence. |
| Blade Runner | blade-runner | Amber/orange on warm black. Neo-noir dystopia. |
| fsociety | fsociety | Green on pure black. Raw hacker aesthetic. |
| Anime | anime | Purple/violet on indigo. Psychic energy. |
Optional CRT scanline overlay 鈥?toggle via theme picker.
Keyboard Shortcuts | Key | Action |
|-----|--------|
| 1-9, 0 | Switch tabs |
| t | Toggle theme picker |
| Ctrl+K | Command palette |
Architecture React Frontend (Vite + SWR)
鈫?/api/* (proxied in dev) + WebSocket /ws
FastAPI Backend (Python)
鈫?collectors/*.py + cache + file watcher
~/.hermes/ (agent data files)
Collectors 鈥?Read from ~/.hermes/ and return dataclassesCaching 鈥?Intelligent cache with mtime-based invalidation (sessions: 30s, skills: 60s, patterns: 60s, profiles: 45s TTL)File Watcher 鈥?Watches ~/.hermes/ for changes using watchfilesWebSocket 鈥?Broadcasts data_changed events to all connected clients
SWR 鈥?Fetches from /api/* with keepPreviousData for silent background updatesWebSocket Hook 鈥?Auto-reconnect with exponential backoff, triggers SWR revalidation on change eventsPanels 鈥?One component per tab, shows stale data during refresh (no loading flashes)
Token Cost Pricing Costs are calculated from token counts using hardcoded per-model pricing. Supported models:
| Provider | Model | Input | Output | Cache Read |
|----------|-------|------:|-------:|-----------:|
| Anthropic | Claude Opus 4 | $15/M | $75/M | $1.50/M |
| Anthropic | Claude Sonnet 4 | $3/M | $15/M | $0.30/M |
| Anthropic | Claude Haiku 3.5 | $0.80/M | $4/M | $0.08/M |
| OpenAI | GPT-4o | $2.50/M | $10/M | $1.25/M |
| OpenAI | o1 | $15/M | $60/M | $7.50/M |
| DeepSeek | V3 | $0.27/M | $1.10/M | $0.07/M |
| xAI | Grok 3 | $3/M | $15/M | $0.75/M |
| Google | Gemini 2.5 Pro | $1.25/M | $10/M | $0.31/M |
Models not in the table fall back to Claude Opus pricing. Local/free models are detected and priced at $0.
Relationship to the TUI This is the browser companion to hermes-hud . Both read from the same ~/.hermes/ data directory independently. You can use either one, or both at the same time.
The Web UI is fully standalone 鈥?it ships its own data collectors and doesn't require the TUI package. It adds features the TUI doesn't have: dedicated Memory, Skills, and Sessions tabs; per-model token cost tracking; command palette; theme switcher with live preview.
If you also have the TUI installed (pip install hermes-hud), you can enable it with pip install hermes-hudui[tui].
Platform Support
macOS 鈥?native, install via ./install.shLinux 鈥?native, install via ./install.shWindows 鈥?via WSL (Windows Subsystem for Linux)WSL 鈥?install script detects WSL automatically
License
Star History Ecosystem Role Standard MoltPulse indexed agent.
Show off your Pulse Score in your GitHub README to build trust and rank higher.
[](https://molt-pulse.com/agents/zhonglouxiaonaigao-art/Hermes-HUD-WebUI-joeynyc-hermes-hudui-)
Copy 
