Hermes HUD Web UI: app and UI for Hermes Agent

Browser dashboard for Hermes Agent covering memory, skills, sessions, costs, cron jobs and health

What Hermes HUD Web UI does

Hermes HUD Web UI is the browser version of the Hermes HUD terminal dashboard. It reads the ~/.hermes/ directory and the hermes CLI directly, then shows 19 tabs: executive dashboard, identity, memory, skills, sessions, replay, cron jobs, projects, health diagnostics, costs, model analytics, patterns, corrections, sudo governance, live chat, OAuth providers, gateway control, plugin management and live model capabilities. Updates arrive over WebSocket without a manual refresh.

The Replay tab turns a Hermes session into redacted, shareable artifacts: JSON, GitHub-ready Markdown, standalone HTML, a PNG share card and a fork.json. Safe Share Mode is the default and redacts tool arguments, terminal output, reasoning, token-like values, emails and local paths. The server is local-only by default and rejects cross-site requests; binding to a LAN needs --host 0.0.0.0 --unsafe-allow-remote. It is verified against Hermes Agent v0.20.3 and keeps compatibility with state.db schemas v16 and v23.

Key features

19 tabs covering memory, skills, sessions, cron jobs, costs, model analytics and health
Real-time updates over WebSocket and filesystem events
Replay tab that exports redacted JSON, Markdown, HTML and PNG share cards
Gateway and plugin management, including Nous Tool Gateway routing visibility
Local-only server by default, with explicit flags for LAN access
Health checks that flag drift from the verified Hermes Agent data layout

When to use it

Check the health, spend and top model of a running Hermes Agent at a glance
Export a redacted replay of a session to attach to a GitHub issue or PR
Manage Hermes plugins and the gateway from a browser

Who it is for: Hermes Agent users who want a browser dashboard for what their agent knows, runs and costs.

How it fits with Hermes Agent

Built for Hermes Agent: it reads the ~/.hermes/ directory and the hermes CLI, and it is verified against Hermes Agent v0.20.3.

How to install Hermes HUD Web UI

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

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

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

FAQ

What is Hermes HUD Web UI?

Hermes HUD Web UI is a browser dashboard for Hermes Agent. It reads local Hermes data and shows memory, skills, sessions, costs, cron jobs and health in 19 tabs.

Does Hermes HUD Web UI work with Hermes Agent?

Yes, it is built for Hermes Agent. It is verified against v0.20.3 (state.db schema v26) and keeps compatibility with schemas v16 and v23.

How do I install Hermes HUD Web UI?

Clone the repository, change into hermes-hudui, run ./install.sh, then start hermes-hudui and open http://localhost:3001. On later runs, activate the virtual environment and start hermes-hudui again.