hermes-webui: Use Hermes Agent in a Web Browser

Overview

Hermes WebUI is a browser-based interface for Hermes Agent. It brings agent chat and related controls into a web app, so users can work with their existing Hermes setup from a browser rather than relying only on a terminal or messaging app.

The project is most relevant to people who self-host Hermes and want a convenient interface across devices. It runs a Python backend with a vanilla JavaScript frontend and uses the existing agent configuration and models.

Key Features

• Stream agent responses in chat, with tool activity, reasoning, and approval prompts displayed in the conversation.
• Manage, search, organize, export, and import sessions, including CLI sessions exposed in the sidebar.
• Browse, preview, edit, and manage files in configured workspaces.
• Switch between agent profiles and configure providers and preferences in the interface.
• Use mobile-responsive layouts, themes, and optional voice input where the browser supports it.
• Add optional password authentication or passkeys, and connect remotely through an SSH tunnel or Tailscale.
• Run the app with Docker or install it declaratively through the provided Nix flake and NixOS module.

Use Cases

• A Hermes user who wants to continue agent conversations from a phone or browser instead of opening a terminal.
• A self-hosting operator who wants a browser interface for sessions, tasks, profiles, and workspace files on a server.
• A developer who wants to review agent tool calls and edit project files from one interface.
• A homelab administrator who prefers a Docker or Nix-based deployment and remote access over a protected tunnel.

Getting Started

Clone the repository and run the bootstrap script:

git clone https://github.com/nesquena/hermes-webui.git
cd hermes-webui
python3 bootstrap.py

See the README for configuration, remote access, Docker, and troubleshooting details.

Considerations

• Hermes Agent is a requirement: the WebUI uses its configuration, models, and runtime rather than acting as a standalone agent interface.
• The README says the bootstrap supports Linux, macOS, and WSL2, but not native Windows. A separate community guide describes a native Windows setup.
• The project imports Hermes Agent modules and reads its state layout directly. The README recommends upgrading or pinning WebUI and Hermes Agent together; mismatched versions are described as untested and unsupported.
• The server binds to localhost by default. Remote or network access requires deliberate configuration, and the README recommends authentication when exposing it beyond localhost.
• The README documents optional Gateway-backed chat, but full agent-loop delegation through that backend is not yet shipped.