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).

Setup Hermes so you can access it natively on every device:




  
    
      
      Light mode with full profile support
    
    
      
      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
- Nix flake/module — declarative install and service
- 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 terminal is reachable from your phone
- Self-improving