hermes-webui 是什么?

Hermes WebUI 是 Hermes Agent 的自托管浏览器界面,以 Python 后端和原生 JavaScript 提供聊天、会话、工作区文件、模型选择、工具审批、定时任务和移动端访问。它复用现有 Hermes Agent 配置、模型和状态。

⭐ 15,268 Stars 🍴 1,976 Forks Python MIT 作者: nesquena
来源:github.com/nesquena/hermes-webui/blob/master/README.md 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目迭代很快:稳定版 v0.52.113 发布后仍持续发布 experimental 标签。WebUI 覆盖 CLI 会话桥接、工具卡、工作区浏览、远程访问和多 provider 选择,使用面广。

来源:github.com/nesquena/hermes-webui/releases/tag/v0.52.113

核心功能

Hermes CLI 的浏览器入口

WebUI 复用本地 Hermes Agent,引入流式聊天、模型与 profile 选择、CLI 会话桥接和项目化会话管理。

来源:github.com/nesquena/hermes-webui/blob/master/README.md
工作区与工具透明度

界面能浏览、编辑、创建、删除和下载工作区文件,并展示工具参数、结果、子 Agent 活动和危险 Shell 命令审批。

来源:github.com/nesquena/hermes-webui/blob/master/README.md
本机与远程访问

默认绑定 127.0.0.1;官方文档支持 SSH tunnel,或在设置密码后通过 Tailscale/非回环地址访问。

来源:github.com/nesquena/hermes-webui/blob/master/README.md;https://github…

技术架构

Python 服务端直接导入 Hermes Agent 的配置、provider、streaming 与状态结构,前端使用原生 JavaScript,无构建步骤。会话、工作区设置和项目等 WebUI 状态默认保存在 ~/.hermes/webui;聊天通常在同一进程里运行 Agent,也可选择 gateway 后端。

来源:github.com/nesquena/hermes-webui/blob/master/README.md;https://github…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 现有 Hermes Agent现有 Hermes Ag… 至少一个已配置模型 provider至少一个已配置模… 可选 Docker/Compose可选 Docker/Co… 可选 SSH 或 Tailscale可选 SSH 或 Tai… Hermes CLI 的浏览器入口Hermes CLI 的浏览器… 工作区与工具透明度 本机与远程访问 hermes-webui 项目本体 核心功能 关键依赖

技术栈

语言Python 3.11+、原生 JavaScript框架Hermes Agent 本地运行时、SSE、可选 gateway
现有 Hermes Agent至少一个已配置模型 provider可选 Docker/Compose可选 SSH 或 Tailscale
默认 127.0.0.1:8787;状态目录 ~/.hermes/webui;稳定与 experimental 两条发行通道
来源:github.com/nesquena/hermes-webui/blob/master/README.md;https://github…

快速上手

准备 Python 3.11+、Linux/macOS/WSL2 和已经备份的 Hermes 配置。克隆仓库后切到稳定标签 v0.52.113,先审阅 bootstrap.py;官方入口是 python3 bootstrap.py,它会检测 Hermes Agent、可能调用官方安装脚本、准备依赖并启动本地服务。保持默认 127.0.0.1:8787,在 /health 正常后完成 provider 设置。不要在未设置认证时改为 0.0.0.0。
来源:github.com/nesquena/hermes-webui/blob/master/README.md;https://github…

使用场景

适合已有 Hermes Agent 的个人用户,通过浏览器或手机管理会话、查看工具过程、操作受限工作区和处理定时任务。它能编辑与删除文件并运行 Agent 工具,服务器暴露、工作区挂载和长期凭据都要按高权限应用管理。

来源:github.com/nesquena/hermes-webui/blob/master/README.md;https://github…

优势与局限

优势

  • 复用 Hermes Agent 的配置、模型和会话
  • 工具卡、审批卡和工作区浏览让执行过程可见
  • 默认只监听回环地址
  • 提供源码、Docker、SSH tunnel 与 Tailscale 路径

局限

  • WebUI 仍直接依赖 Hermes Agent 内部模块和状态布局,版本错配可能导致导入或行为漂移
  • bootstrap 可能下载安装 Hermes Agent 与依赖,运行前应审阅脚本
  • WebUI 可读写工作区并批准 Shell 命令,错误授权影响本机文件
  • 远程开放必须配置密码并处理 TLS、网络边界和会话数据
  • 原生 Windows bootstrap 尚不受支持
  • 本轮没有安装或启动服务
来源:github.com/nesquena/hermes-webui/blob/master/README.md;https://github…

最新版本

最新稳定版为 v0.52.113,发布于 2026-08-14;GitHub 将其标为 Latest。仓库另有快速推进的 exp-v* 预发行线,截至 2026-09-22 为 exp-v0.52.339。experimental 文档明确不适合生产,部署时不要把 :experimental 或 latest 与另一侧固定版本混用。

来源:github.com/nesquena/hermes-webui/releases/tag/v0.52.113;https://githu…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、pyproject.toml、ARCHITECTURE、Docker/remote access 文档、稳定版与 experimental Release  |  limitations: 未克隆或运行 bootstrap、未安装 Hermes Agent、未配置 provider、未挂载工作区、未开放端口,也未测试稳定版与 Agent 的兼容组合  |  observed_output: 稳定版为 v0.52.113(2026-08-14),最新 experimental 记录为 exp-v0.52.339(2026-09-22);pyproject 要求 Python >=3.11,README 默认绑定 127.0.0.1:8787

来源:github.com/nesquena/hermes-webui/releases/tag/v0.52.113;https://githu…

同类项目对比

Open WebUI 官方项目面向 Ollama 与 OpenAI 兼容 API,提供通用的自托管模型聊天平台,并支持 Docker、Kubernetes 和多种模型后端。Hermes WebUI 专门贴合 Hermes Agent,包含 Agent 工具审批、工作区文件、CLI 会话、持久记忆和定时任务。只需要通用模型聊天界面可看 Open WebUI;已经采用 Hermes 并需要完整 Agent 操作面时,Hermes WebUI 更贴近其状态模型。

来源:github.com/open-webui/open-webui;https://github.com/nesquena/hermes-w…

总结评价

已有 Hermes Agent 且需要浏览器操作面时,这个 WebUI 很实用。先固定稳定版和匹配的 Agent,保持回环监听,在只含测试文件的工作区检查审批、会话和状态目录;验证清楚后再考虑远程访问。

来源:github.com/nesquena/hermes-webui/blob/master/README.md;https://github…

常见问题

Hermes WebUI 当前稳定版和实验版分别是什么?

稳定版是 v0.52.113,发布于 2026-08-14;截至核对时最新实验版是 exp-v0.52.339,发布于 2026-09-22。生产使用应固定稳定标签。

Hermes WebUI 可以直接暴露到公网吗?

默认只绑定 127.0.0.1。需要远程访问时优先使用 SSH tunnel;若绑定非回环地址,官方要求至少设置 HERMES_WEBUI_PASSWORD,并继续补 TLS 与网络访问控制。

Hermes WebUI 支持原生 Windows bootstrap 吗?

官方 README 明确说当前原生 Windows 不支持该 bootstrap,推荐 Linux、macOS 或 WSL2;社区原生 Windows 路径存在额外限制。

为什么 Hermes Agent 和 WebUI 要一起固定版本?

WebUI 仍直接导入 Agent 内部模块并读取其状态布局。官方兼容策略建议两者同一发布周期升级或同时固定,避免导入和状态结构漂移。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件