nesquena / hermes-webui

Hermes Web UI 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. Hermes Web UI 是一个运行在服务器上的高级自主智能体，可通过终端或消息应用访问。它能记住学习到的内容，且运行时间越长能力越强。Hermes WebUI 是一个轻量级的深色主题网页界面，用于在浏览器中操作 Hermes Agent。它与 CLI（命令行）体验完全对等——你在终端能做的所有事情，在这个 UI 中都能完成。无需构建步骤、无需框架、无需打包工具，仅使用 Python 和原生 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). 布局采用三栏式：左侧边栏用于会话和导航，中间为聊天窗口，右侧为工作区文件浏览。模型、个人资料和工作区控件位于输入框底部，在编写时始终可见。一个圆形的上下文环可以直观地显示 Token 使用情况。所有设置和会话工具均位于 Hermes 控制中心（位于侧边栏底部的启动器）。

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. 支持完整个人资料的浅色模式。你可以自定义设置并配置密码。工作区文件浏览器支持内联预览。包含会话项目、标签和工具调用卡片。这为你提供了一个便捷的 Web UI，使其与 Hermes CLI 几乎 1:1 对等，你可以通过 SSH 隧道从你的 Hermes 设置中安全地访问它。只需一条命令即可启动，再用一条命令即可通过 SSH 隧道在电脑上访问。Web UI 的每一个部分都使用你现有的 Hermes Agent 和模型，无需任何额外配置。

Why Hermes

为什么选择 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. 大多数 AI 工具在每次会话后都会重置。它们不知道你是谁、你做过什么，也不了解你的项目遵循什么规范。你必须每次都重新解释自己。Hermes 可以在会话间保留上下文，在你离线时运行定时任务，并且运行时间越长，对你的环境就越了解。它使用你现有的 Hermes Agent 设置和模型，无需额外配置即可启动。

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.
持久化记忆 — 包含用户资料、智能体笔记和一个保存可重用流程的技能系统；Hermes 会学习你的环境，无需重复学习。
Self-hosted scheduling — cron jobs that fire while you’re offline and deliver results to Telegram, Discord, Slack, Signal, email, and more.
自托管定时任务 — Cron 任务可以在你离线时触发，并将结果发送到 Telegram、Discord、Slack、Signal、电子邮件等平台。
10+ messaging platforms — the same agent available in the terminal is reachable from your phone.
10+ 种消息平台 — 在终端中使用的同一个智能体，现在也可以通过手机访问。
Self-improving skills — Hermes writes and saves its own skills automatically from experience; no marketplace to browse, no plugins to install.
自我提升的技能 — Hermes 根据经验自动编写并保存自己的技能；无需浏览市场，也无需安装插件。
Provider-agnostic — OpenAI, Anthropic, Google, DeepSeek, OpenRouter, and more.
模型供应商中立 — 支持 OpenAI、Anthropic、Google、DeepSeek、OpenRouter 等。
Orchestrates other agents — can spawn Claude Code or Codex for heavy coding tasks and bring the results back into its own memory.
编排其他智能体 — 可以调用 Claude Code 或 Codex 来处理繁重的编码任务，并将结果带回其自身的记忆中。
Self-hosted — your conversations, your memory, your hardware.
自托管 — 你的对话、你的记忆、你的硬件。

Quick start

快速开始

Run the repo bootstrap: 运行仓库引导程序：

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

Or keep using the shell launcher: 或者继续使用 shell 启动器：

./start.sh

For self-hosted VM or homelab installs, ctl.sh wraps the common daemon lifecycle commands without requiring fuser or pkill: 对于自托管虚拟机或家庭实验室安装，ctl.sh 封装了常见的守护进程生命周期命令，无需使用 fuser 或 pkill：

./ctl.sh start # background daemon, PID at ~/.hermes/webui.pid
./ctl.sh status # PID, uptime, bound host/port, log path, /health
./ctl.sh logs --lines 100 # tail ~/.hermes/webui.log
./ctl.sh restart
./ctl.sh stop

ctl.sh start runs the bootstrap in foreground/no-browser mode behind the daemon wrapper, writes logs to ~/.hermes/webui.log, and respects .env plus inline overrides such as HERMES_WEBUI_HOST=0.0.0.0 ./ctl.sh start. ctl.sh start 在守护进程包装器下以前台/无浏览器模式运行引导程序，将日志写入 ~/.hermes/webui.log，并遵循 .env 文件以及内联覆盖，例如 HERMES_WEBUI_HOST=0.0.0.0 ./ctl.sh start。