hermes-webui

nesquena/hermes-webui

A lightweight, dark-themed web app interface for Hermes Agent.

16k
Stars
2.1k
Forks
228
Open issues
49
Watchers
Python MITLast pushed Jul 7, 2026

Overview

Hermes WebUI is a Python-based web application that provides full parity with the command-line interface experience of Hermes Agent. It offers a three-panel layout with navigation, chat functionality, and file browsing capabilities.

Categories

Tags

Similar tools

Install

pip install hermes-webui

README

Hermes Web UI

Hermes Agent is a sophisticated autonomous agent that lives on your server, accessed via a terminal or messaging apps, that remembers what it learns and gets more capable the longer it runs.

Hermes WebUI is a lightweight, dark-themed web app interface in your browser for Hermes Agent. Full parity with the CLI experience - everything you can do from a terminal, you can do from this UI. No build step, no framework, no bundler. Just Python and vanilla JS.

Layout: three-panel. Left sidebar for sessions and navigation, center for chat, right for workspace file browsing. Model, profile, and workspace controls live in the composer footer — always visible while composing. A circular context ring shows token usage at a glance. All settings and session tools are in the Hermes Control Center (launcher at the sidebar bottom).

Hermes Web UI — three-panel layout
Light mode with full profile support
Light mode with full profile support
Customize your settings, configure a password
Customize your settings, configure a password

Workspace file browser with inline preview

Session projects, tags, and tool call cards

This gives you nearly 1:1 parity with Hermes CLI from a convenient web UI which you can access securely through an SSH tunnel from your Hermes setup. Single command to start this up, and a single command to SSH tunnel for access on your computer. Every single part of the web UI uses your existing Hermes agent and existing models, without requiring any additional setup.


Contents

  • Why Hermes — what it is and how it compares
  • Quick start — clone + bootstrap.py / start.sh / ctl.sh
  • Features — chat, sessions, workspace, voice, profiles, security, themes, panels, mobile
  • Configuration & access — auto-discovery, overrides, remote/Tailscale/phone, manual launch
  • Docker — single- and multi-container deploys
  • Running tests
  • Architecture — backend/frontend layout, state dir
  • Docs — the full documentation index
  • Contributors

Why Hermes

Most AI tools reset every session. They don't know who you are, what you worked on, or what conventions your project follows. You re-explain yourself every time.

Hermes retains context across sessions, runs scheduled jobs while you're offline, and gets smarter about your environment the longer it runs. It uses your existing Hermes agent setup, your existing models, and requires no additional configuration to start.

What makes it different from other agentic tools:

  • Persistent memory — user profile, agent notes, and a skills system that saves reusable procedures; Hermes learns your environment and does not have to relearn it
  • Self-hosted scheduling — cron jobs that fire while you're offline and deliver results to Telegram, Discord, Slack, Signal, email, and more
  • 10+ messaging platforms — the same agent available in the