Hermes WebUI：浏览器里的 AI 终端，用你最熟悉的界面驾驭最强 Agent

想象这样一个场景：你是一位独立开发者，手头有三个项目同时推进，每个项目都有各自的 AI 对话上下文——但大多数 AI 工具一旦关闭对话就"失忆"了，你每天要花大量时间重新解释项目背景。更别提当你出门在外、需要用手机处理紧急问题时，根本没有办法在终端里高效操作。

Hermes WebUI 就是为解决这些问题而生的。

背景：为什么 Hermes Agent 需要一个 Web 界面

Hermes Agent 是 Nous Research 团队打造的一个自主运行 AI Agent，能够在服务器上持续运行、记住跨会话的上下文、自动执行定时任务。与每次都要"从零开始"的普通 AI 聊天工具不同，Hermes Agent 真正理解你的工作环境和项目惯例。

然而，Hermes Agent 本身只能通过终端或消息应用访问。对于需要多窗口操作、文件预览、甚至在手机上管理会话的用户来说，纯命令行的体验存在明显短板。Hermes WebUI 正是为了补足这一环而诞生的——它用纯浏览器界面呈现 Hermes Agent 的完整能力，不需要任何构建步骤、不引入前端框架、不需要打包工具。

用作者的话说："everything you can do from a terminal, you can do from this UI"——终端能做的，Web 界面都能做。

类比：给你的 AI 终端装上"图形界面"

如果把 Hermes Agent 比作一台强大的远程服务器，Hermes WebUI 就相当于给这台服务器加了一个浏览器里的"远程桌面"。你不需要 SSH 到服务器上操作，只需要打开浏览器、输入地址，就能像在本地一样管理会话、浏览文件、调用工具。

*图1：Hermes WebUI 工作区文件浏览器，支持内联预览

核心功能：从三栏布局到完整功能集

三栏布局设计：左侧边栏用于会话管理和导航；中央区域是聊天主界面；右侧面板默认折叠，在浏览工作区文件时展开预览。这种设计直接对标 Claude Code 的经典布局，对已习惯图形化 IDE 的用户非常友好。

Hermes Control Center（控制中心）：底部有一个统一的入口按钮，打开后是标签式弹窗，涵盖全局设置、对话导入导出、清空对话等所有非对话的操作。这避免了界面顶部堆砌过多按钮，保持了对话区域的清爽。

会话持久化与上下文保持：这是 Hermes 体系的核心优势。WebUI 完全复用已有的 Hermes Agent 配置和模型，无需重新初始化或额外配置。每个会话都保留历史上下文，即使切换到手机浏览器也能无缝衔接。

Profile 感知：支持多 Profile（不同配置/模型组合），WebUI 能动态发现可用模型，支持自定义 Provider 作用域。

暗色主题 + PWA 支持：默认暗色主题，带浅色模式切换。同时支持 PWA（渐进式 Web 应用），可以在手机/桌面"安装"为独立应用图标。

技术架构：极简主义的技术实现

后端：纯 Python 标准库（http.server + ThreadingHTTPServer），不依赖 Flask/FastAPI 等 Web 框架。约 446 行核心代码，通过路由分发给 api/routes.py，业务逻辑全部分散在 50+ 个独立模块中（api/ 目录）。

前端：7 个原生 JavaScript 模块 + 1 个 CSS 文件，无任何前端框架或构建工具。boot.js 负责应用初始化，sessions.js 管理会话，panels.js 控制侧边栏，workspace.js 处理文件浏览。这种架构使得所有代码都可在终端中直接修改，对 Agent 友好。

会话流式传输：基于 SSE（Server-Sent Events），由 WebUI 自持流控制逻辑（流所有权守卫、取消、超时压缩）。

测试覆盖：v0.51.54 版本有 5303 个测试用例，CI 在 Python 3.11/3.12/3.13 上运行。测试网络隔离机制（HERMES_WEBUI_TEST_NETWORK_BLOCK）确保测试环境完全隔离。

部署方式：

• 单容器：docker compose up -d → http://localhost:8787
• 双容器：分离 Agent 和 WebUI 进程
• 三容器：Agent + WebUI + Dashboard
• 裸机：start.sh 或 ctl.sh（后台守护进程）

上手门槛

如果你已经部署了 Hermes Agent，添加 WebUI 只需要一行命令。docker-compose.yml 已配置好卷挂载，自动复用你的 ~/.hermes 配置。如果还没有 Hermes Agent，bootstrap.py 提供一键引导安装。

没有 GPU 需求，纯 Python 服务，资源占用极低。

争议与局限

没有内置用户认证（除非配置密码）：默认通过 SSH 隧道访问，不暴露公网。官方推荐通过 127.0.0.1:8787 仅绑定本地回环地址，通过 SSH 隧道远程访问。如果直接暴露到公网，需要手动配置认证。

依赖 Hermes Agent 本身：WebUI 本质上是 Hermes 的"壳"，没有 Hermes Agent 它无法独立工作。对于只想体验 Web 界面的新用户，存在一定上手门槛。

行业意义

Hermes WebUI 代表了一种新兴趋势：将强大的本地 AI 工具图形化。随着 Agent 技术从极客玩具走向生产力工具，用户对"在任意设备上操作 Agent"的需求日益强烈。Hermes WebUI 通过极简的技术实现（零依赖前端 + Python 标准库后端）证明了：不需要 React/Vue，不需要 Node.js 构建链，一个 7 文件的 HTML/JS/CSS 组合就能实现专业级 Web 界面。

其高频迭代节奏（每 1-2 天一个版本）和 9000+ 的 GitHub Stars 也印证了社区对"本地部署 + 浏览器访问"这一路径的强烈认同。