nesquena /hermes-webui

Hermes WebUI: The best way to use Hermes Agent from the web or from your phone!

★ 19,531⑂ 2,836👁 60⑃ 6,738● 2,318▤ 1,852
PythonMITCreated 2026-03-30get-hermes.ai/setup
Download: v0.52.678v0.52.678 ↓0.52.6782026-11-15
+13
Daily
+157
Weekly
+652
Monthly
19,531
stars
2,836
forks
60
watchers
6,738
prs
2,318
issues
1,852
releases

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

Top issues

Discussions

Latest release

v0.52.678 v0.52.678 2026-11-15
Known issues
- Context meter after a reload or model switch (8975). For some sessions on custom or self-hosted endpoints, the
  context meter can show the default window (256K) instead of the model's real window after a page reload or a model
  switch. It corrects itself on the next turn. Compression and chats are unaffected. Context-management plugins that
  read WebUI's context window see the same default until then.
- Credentials can pair with the wrong URL on Agent builds after hermes-agent 151775 when a providers: entry named like a built-in provider has its own URL and model.base_url dif

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON