Skip to content

xiaopengsvip/hermes-hudui

 
 

Repository files navigation

☤ 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.

Token Costs

Agent Profiles

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.

Themes

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

Keyboard Shortcuts

Key Action
19, 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.


Star History Chart

About

Web UI consciousness monitor for Hermes — the AI agent with persistent memory

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 51.5%
  • TypeScript 43.9%
  • CSS 3.0%
  • Other 1.6%