Hermes WebUI
A browser-based chat interface for the Hermes Agent, usable from a desktop or phone.
- Stars
- 19.4k
- Forks
- 2.8k
- Licence
- MIT
- Language
- Python
- Last update
- 4 days ago
- Type
- App
What it is
Hermes WebUI is a lightweight, dark-themed web interface that lets you use Hermes Agent from your browser instead of a terminal. The README says it aims for near 1:1 parity with the Hermes CLI and is built with Python and plain JavaScript, with no build step. You can reach it on a server through an SSH tunnel, and it uses your existing Hermes setup and models.
- Chat with your Hermes agent from a browser on your computer or phone
- Browse and preview workspace files in the right-hand panel while chatting
- Manage sessions, projects, and tags from the sidebar
- Start and stop the server as a background daemon with ctl.sh
Great for
- People who already run Hermes Agent and want a browser or phone interface
- Developers who want a three-panel chat view with workspace file browsing
- Self-hosters on a VM or homelab who want a daemon-style setup via ctl.sh
Not ideal for
- People who do not have Hermes Agent installed, since WebUI depends on it
- Anyone wanting a standalone chat app with no server to run, because it runs on your own host
- Users who need chat routed through an external API server by default, since the README says chat runs in-process unless you configure otherwise
How to get it
- 1
Clone and build from source
You'll need: Python 3
Clone the repository
git clone https://github.com/nesquena/hermes-webui.git hermes-webuiEnter the project folder
cd hermes-webuiRun the bootstrap script
python3 bootstrap.py - 2
Run it
- Clone the repository and enter the folder
- Run python3 bootstrap.py, or ./start.sh as an alternative
- Open the web UI in your browser (the README notes the default port is 8787 in its stop instructions)
- Optionally run ./ctl.sh start to run it as a background daemon
- 3
Get the most out of it
- Use ./ctl.sh status and ./ctl.sh logs to check health and read logs at ~/.hermes/webui.log
- Set HERMES_WEBUI_HOST=0.0.0.0 inline or in .env if you need to bind to other interfaces, noting the security implications
- Add an external OpenAI-compatible endpoint under Settings → Providers to use its models for chat
- Set a password in the settings to protect access, as shown in the README screenshots
- Read docs/advanced-chat-setup.md for Gateway-backed chat and session-recall prefill
Downloads
Strengths
- Uses your existing Hermes agent and models without extra setup, according to the README
- Simple stack with no build step, framework, or bundler
- Supports secure remote access through an SSH tunnel
Trade-offs
- The README describes several configuration paths (Gateway, custom providers, Tailscale) that add complexity
- Chat routing and some features are described as partial or still being tracked in issues
- Requires a running Hermes installation and a server you control
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| hermes-webui (this) | 19.4k | App | intermediate | 4 days ago | People who already run Hermes Agent and want a browser or phone interface |
| LibreChat | 46.6k | App | intermediate | 4 days ago | Teams that want one shared chat interface across several AI providers |
| hermes-agent | 260k | AI model / agent | intermediate | 4 days ago | Developers who want a personal agent they can host on their own server or machine |
| anything-llm | 67.8k | App | beginner | 6 days ago | People who want a private ChatGPT-style assistant over their own PDFs and text files |
| page-agent | 29.6k | Library | intermediate | 6 days ago | Developers adding an AI copilot to their own web app |
| Octop | 11.5k | App | intermediate | 4 days ago | Households or small teams that want a shared, self-hosted assistant |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.