ghcr.io/nesquena/hermes-webui:0.50.272

Hermes Web UI

Hermes Agent 是一款运行在服务器上的高级自主代理，可通过终端或消息应用访问，它能记住所学知识，运行时间越长，能力越强。

Hermes WebUI 是用于 Hermes Agent 的轻量级深色主题 Web 应用界面，可在浏览器中使用。与 CLI 体验完全对等——所有能在终端完成的操作，都能通过此 UI 完成。无需构建步骤，无需框架，无需打包工具。仅需 Python 和原生 JS。

布局：三面板。左侧边栏用于会话和导航，中间为聊天区域，右侧为工作区文件浏览。模型、配置文件和工作区控制位于创作区底部——创作时始终可见。环形上下文指示器可直观显示 tokens 使用情况。所有设置和会话工具均位于 Hermes 控制中心（侧边栏底部的启动器）。

• 支持完整配置文件的浅色模式
• 自定义设置，配置密码
• 带内联预览的工作区文件浏览器
• 会话项目、标签和工具调用卡片

这使您能通过便捷的 Web UI 获得与 Hermes CLI 几乎 1:1 的对等体验，您可通过 Hermes 环境中的 SSH 隧道安全访问该 UI。只需一条命令即可启动，一条命令建立 SSH 隧道即可在电脑上访问。Web UI 的所有部分均使用您现有的 Hermes agent 和模型，无需额外设置。

本地构建

docker build -t hermes-webui .
docker run -d \
-e WANTED_UID=$(id -u) -e WANTED_GID=$(id -g) \
-v ~/.hermes:/home/hermeswebui/.hermes \
-e HERMES_WEBUI_STATE_DIR=/home/hermeswebui/.hermes/webui \
-v ~/workspace:/workspace \
-p 127.0.0.1:8787:8787 \
hermes-webui

• 在服务器以及 iPhone/Android 设备上安装 Tailscale。
• 启动 WebUI 使其监听所有接口并启用密码认证：

HERMES_WEBUI_HOST=0.0.0.0 HERMES_WEBUI_PASSWORD=your-secret ./start.sh

• 在手机浏览器中打开 http://<tailscale-ip>:8787（在 Tailscale 应用中或在服务器上使用 tailscale ip -4 命令查找服务器的 Tailscale IP）。

就是这样。流量通过 *** 进行端到端加密，密码认证在应用层保护 UI。您可以将其添加到主屏幕，获得类应用体验。

[!NOTE] 提示：如果使用 Docker，请在 docker-compose.yml 的环境变量中设置 HERMES_WEBUI_HOST=0.0.0.0（已是默认值）并设置 HERMES_WEBUI_PASSWORD。

手动启动（不使用 start.sh）

如果您希望直接启动服务器：

cd /path/to/hermes-agent # 或任何 sys.path 能找到 Hermes 模块的位置
HERMES_WEBUI_PORT=8787 venv/bin/python /path/to/hermes-webui/server.py

[!NOTE] 注意：使用代理的虚拟环境 Python（或任何已安装 Hermes 代理依赖的 Python 环境）。系统 Python 会缺少 openai、httpx 和其他必要包。

健康检查：

curl http://127.0.0.1:8787/health

运行测试

测试会动态发现仓库和 Hermes 代理——无硬编码路径。

cd hermes-webui
pytest tests/ -v --timeout=60

或显式使用代理虚拟环境：

/path/to/hermes-agent/venv/bin/python -m pytest tests/ -v

测试在端口 8788 上的隔离服务器运行，使用独立的状态目录。不会触及生产数据和实际 cron 任务。当前数量：100 多个测试文件共 3309 个测试。

功能

聊天与代理

• 通过 SSE 实现流式响应（生成令牌时即时显示）
• 多提供商模型支持——任何 Hermes API 提供商（OpenAI、Anthropic、Google、DeepSeek、Nous Portal、OpenRouter、MiniMax、Z.AI）；根据配置的密钥动态填充模型下拉列表
• 处理消息时发送新消息——会自动排队
• 内联编辑任何历史用户消息并从该点重新生成
• 一键重试上次助手响应
• 直接从编辑器底部取消正在运行的任务（发送按钮旁的停止按钮）
• 内联工具调用卡片——每张卡片显示工具名称、参数和结果片段；多工具轮次的全部展开/折叠切换
• 子代理委托卡片——子代理活动显示独特图标和缩进边框
• 内联渲染 Mermaid 图表（流程图、序列图、甘特图）
• 思考/推理显示——用于 Claude 扩展思考和 o3 推理块的可折叠金色主题卡片
• 危险 shell 命令的审批卡片（允许一次/会话/始终/拒绝）
• 网络中断时 SSE 自动重连（SSH 隧道恢复能力）
• 文件附件在页面重新加载后保持存在
• 消息时间戳（每条消息旁显示 HH:MM，悬停时显示完整日期）