Hermes WebUI by sanchomuzax: app and UI for Hermes Agent

What Hermes WebUI does

The dashboard shows a real-time activity feed with session list, gateway status, platform health, cost tracking and model distribution, lets you browse and full-text search (FTS5) past conversation histories at the message level, and view (read-only) config.yaml and environment variables. Cron jobs and installed skills, both built-in and custom, are browsable with full source inspection, and the layout is mobile-friendly with a dark/light theme toggle.

It reads from Hermes' unmodified state.db (read-only SQLite) and config.yaml through a FastAPI backend and a React/Vite/TailwindCSS frontend, updated live over a WebSocket polling bridge with no changes required to the agent's own code. On first run it prints a one-time auth token that is also stored in ~/.hermes/auth.json, used to log into the web interface.

Key features

Real-time activity feed: sessions, gateway status, platform health, cost, model mix
Full-text (FTS5) search across past conversation histories at message level
Read-only config.yaml and environment-variable viewer for safety
Cron job and skill browser with full source inspection
WebSocket-based live updates with no modification to Hermes Agent's own code

When to use it

Watching gateway and platform health for a running Hermes Agent from a browser
Searching past Hermes conversation histories without digging through log files
Reviewing which cron jobs and skills are installed, with their full source visible

Who it is for: Hermes Agent users who want a visual, browser-based view of sessions, cron jobs, skills and cost instead of CLI commands.

How it fits with Hermes Agent

Hermes WebUI is built specifically to monitor and display a running Hermes Agent installation, reading its data files without modifying the agent's core code.

How to install Hermes WebUI

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/sanchomuzax/hermes-webui.git
cd hermes-webui
python3 -m venv venv
source venv/bin/activate

Requirements: Python 3.11+, Node.js 18+ for the frontend build, and a running Hermes Agent installation at ~/.hermes/

FAQ

What is Hermes WebUI?

Hermes WebUI is a browser dashboard that shows a running Hermes Agent's sessions, gateway status, cron jobs, skills and cost tracking, reading the agent's own data files without modifying them.

Does Hermes WebUI work with Hermes Agent?

Yes, it is built specifically to read and display a Hermes Agent installation's state.db and config.yaml, requiring a running Hermes Agent at ~/.hermes/.

How do I install Hermes WebUI?

Clone the repository, set up a Python virtual environment and run pip install -e ., then build the frontend with npm install && npx vite build before starting it with hermes-webui.