Hermes HUD 网页版
在浏览器里实时查看 Hermes agent 的健康、记忆、花费与运行轨迹。
- Star 数
- ★ 1.8k
- 最近更新
- 14 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 55/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 运维或平台工程师在长时间运行的 Hermes agent 上排查异常，希望用健康页和诊断项定位数据布局或 schema 漂移。
- 不适合
- 不运行 Hermes agent、没有 ~/.hermes/ 数据的团队
- 希望直接暴露到公网而不另加认证与 TLS 的用户
- 需要托管 SaaS 版本、不愿自行部署的人
- 源码审查
- 55/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Hermes HUD Web UI 是 Hermes（具备持久记忆的 AI agent）的浏览器端监控面板，与同作者的 TUI 版 hermes-hud 读取同一份 ~/.hermes/ 数据目录，可单独使用也可同时开启。项目以 install.sh 安装，启动后打开 http://localhost:3001，通过 WebSocket 推送实时更新，无需手动刷新。默认只监听本机，会拒绝跨站浏览器请求、不可信 WebSocket 来源和非回环地址访问；若要绑定到可信内网，需要显式传入 --host 0.0.0.0 --unsafe-allow-remote 与 --allowed-origin。面板共 19 个标签页，覆盖仪表盘、身份、记忆、技能、会话、回放、定时任务、项目、健康诊断、成本、模型分析、模式、纠正、sudo 治理、实时聊天、OAuth 提供方、网关控制、插件管理以及模型能力。README 声明已针对 Hermes Agent v0.20.3（state.db schema v26）验证，并保留对 schema v16 和 v23 的兼容，健康页的 Agent data layout 与 Agent schema version 检查会提示数据是否偏离该基线。
HUD 直接读取 ~/.hermes/ 目录与 hermes CLI，默认使用原生文件系统事件，在 NFS、WSL1、虚拟机共享或 bind mount 等事件不可靠的环境下可通过 HERMES_HUD_FORCE_POLLING=1 切换为轮询。Dashboard 汇总健康状态、花费脉动、最常用模型、提供方/网关风险、成本最高的会话与待办事项；Health 页在文件系统和 WebSocket 更新时响应，同时限流高开销刷新路径。网关视图展示网页搜索、图像生成、文本转语音和浏览器自动化这些受管工具的走向，标明是经由 Nous Tool Gateway、直连密钥还是不可用，Update hermes 动作为两次点击并显示上次运行日志与状态。Plugin Hub 列出已安装的仪表盘与 agent 插件、扩展入口、运行状态、所需鉴权命令，并提供安全的启用/禁用/更新操作。Hermes Replay 把 agent 运行记录转成经脱敏的可分享产物，本地写入 ~/.hermes-hud/replays/，默认不上传，导出脱敏 JSON、GitHub 用 Markdown、独立 HTML、1200x630 PNG 分享卡与 fork-safe fork.json，并附带本机生成的哈希与 Ed25519 签名。可选远程发布通过 git 仓库和分支把已发布回放同步为静态站点，公开回放进入画廊索引，未列出的只能通过不可猜测的哈希路径访问，默认关闭且仅同步 Safe Share Mode 产物。
- 运维或平台工程师在长时间运行的 Hermes agent 上排查异常，希望用健康页和诊断项定位数据布局或 schema 漂移。
- 关注成本的个人开发者用模型分析页按模型查看 token 与花费，并找出成本最高的会话。
- 需要向团队或社区证明 agent 行为时，用 Replay 导出脱敏的 JSON/HTML/PNG 产物附到 issue 或 PR 上。
- 安全负责人借助 sudo 治理与网关受管工具视图，确认哪些工具走 Nous Tool Gateway、哪些用直连密钥或不可用。
- 中文用户或习惯浏览器的用户不想开终端 TUI，直接切换语言到中文并使用主题切换与命令面板。
- 自建插件生态的开发者通过 Plugin Hub 查看扩展入口、运行状态与鉴权命令，并安全地启用或停用。
如何安装或部署这个 Agent？
前置条件：Python 3.11+、Node.js 22.12+，以及一个正在运行、数据位于 ~/.hermes/ 的 Hermes agent。
git clone https://github.com/joeynyc/hermes-hudui.git
cd hermes-hudui
./install.sh
hermes-hudui启动后访问 http://localhost:3001。若还要在同一环境里安装 TUI，可执行下列命令（zsh 中引号是必需的）：
pip install 'hermes-hudui[tui]'如何使用这个 Agent？
后续启动：
source venv/bin/activate && hermes-hudui在 NFS、WSL1、虚拟机共享或 bind mount 上运行时，文件系统事件可能不可靠，改为轮询：
HERMES_HUD_FORCE_POLLING=1 hermes-hudui要刻意绑定到可信内网（默认仅本机、拒绝跨站请求与不可信 WebSocket 来源）：
hermes-hudui --host 0.0.0.0 --unsafe-allow-remote --allowed-origin https://hud.example.test快捷键：1–9、0 切换标签页，t 打开主题选择，Ctrl+K 打开命令面板；标题栏最右侧的语言按钮在英文与中文之间切换，选择会写入 localStorage。对外暴露前请在 HUD 前面加上认证与 TLS。
这个 Agent 有哪些优点和局限？
- 与 TUI 版 hermes-hud 读取同一份 ~/.hermes/ 数据，可同时运行，互为补充。
- 默认本地优先的安全姿态：拒绝跨站请求与不可信 WebSocket 来源，远程绑定必须显式加参数并配合 --allowed-origin。
- Replay 默认执行 Safe Share Mode，脱敏工具参数、终端输出、助手推理、疑似令牌、邮箱与本地路径后再导出多种静态产物。
- 网关视图能区分 Nous Tool Gateway、直连密钥与不可用三种路由状态，Update hermes 采用两次点击并展示上次日志。
- 自带中英双语界面、五个可切换主题、命令面板与响应式标签栏。
- 强绑定 Hermes agent：必须已有运行中的 Hermes 且数据在 ~/.hermes/，其他 agent 无法受益。
- 同时需要 Python 3.11+ 与 Node.js 22.12+，并通过 install.sh 建立虚拟环境，环境准备比纯 pip 安装更重。
- README 仅声明已验证 Hermes Agent v0.20.3（schema v26）并兼容 v16、v23，其他 schema 需依靠健康页检查判断。
- 导出附带的哈希与 Ed25519 签名只证明本地产物完整性，不构成第三方外部背书。
- 远程发布需要自行配置 git 仓库与分支并依赖本机 git 凭据，项目不提供托管服务。
这个 Agent 与同类方案有什么区别？
同作者的 TUI 版 hermes-hud 是直接对照物：两者独立读取同一 ~/.hermes/ 数据目录，可任选其一或同时使用；Web UI 完全独立运行，并额外提供 Memory、Skills、Sessions、Replay、Health、Providers、Gateway、Model、Plugins 等专属标签页、按模型的 token 与成本分析、网关受管工具可见性、可操作诊断、命令面板、实时聊天与主题切换。若已装 TUI，可通过 pip install 'hermes-hudui[tui]' 一起启用。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Hermes HUD 网页版 当前 | 55 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.8k | 14 天前 | Python | — |
| AgentOps 可观测性平台 | 50 · 缺口较多 | 代码库 / SDK免费版 + 付费版 | ★ 5.9k | 3 个月前 | Python | OpenAI API · Claude API |
| Arize Phoenix | 61 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 12k | 今天 | Python | OpenAI API · Claude API |
| AgentSight | 77 · 存在缺口 | 命令行工具免费 | ★ 732 | 4 天前 | C | Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 明确说明服务默认仅本地监听、拒绝跨站请求与非回环访问，远程绑定需显式 --unsafe-allow-remote 并配合 --allowed-origin，属于最小权限与外部效应的合理默认（least_privilege=2, external_effects=2）。Update hermes 为两次点击确认，远程发布默认关闭且仅手动触发，用户确认有据（user_confirmation=2）。Replay 导出默认 Safe Share Mode，对工具参数、终端输出、推理、token、邮箱、本地路径做脱敏，并说明签名仅证明本地完整性，数据流透明与敏感数据处理有实质描述（data_flow_transparency=2, sensitive_data_handling=2）。依赖为 fastapi/uvicorn/pyyaml/watchfiles/pillow/cryptography 等主流库，CI 含 npm audit --audit-level=high 与 CodeQL，但 Python 侧无 pip-audit 或锁定文件，故 dependency_security=2 而非 3。回滚方面仅提到 Update hermes 显示上次日志/状态，未见版本回退或备份恢复机制，rollback=1。来源归属仅 README 与 pyproject 指向同一仓库与作者，无上游 Hermes 版本锁定或第三方来源说明，source_attribution=1。未发现恶意、凭据窃取、隐蔽外传或破坏性默认等红线。
README 与 pyproject 在 Python 3.11+、Node 22.12+、端口 3001、CLI 入口 hermes-hudui 上一致，CI 覆盖 3.11/3.12/3.13 并做 wheel 冒烟测试，自洽性良好（self_consistency=2）。依赖均为公开 PyPI 包，CI 使用 npm ci 与 pip 安装，可用性可预期（dependency_availability=2）。但除 Health 标签页的 schema 漂移检查外，未见对 Hermes 缺失、数据目录为空、WebSocket 断连等失败路径的具体错误文案或恢复指引，failure_messages=1。
README 明确目标用户为 Hermes 用户，列出 19 个标签页、主题、快捷键、中英双语与 macOS/Linux/WSL 平台，场景与受众清晰（audience_and_scenarios=2）。能力边界有说明：仅读取 ~/.hermes/ 与 hermes CLI，远程暴露需自行加认证与 TLS，Replay 签名不构成第三方证明（capability_boundaries=2）。触发精度方面，仅描述标签页与快捷键，未给出何时应使用 HUD 而非 TUI 或 CLI 的判定条件，trigger_precision=1。环境适配较好：NFS/WSL1/VM 共享可用 HERMES_HUD_FORCE_POLLING=1，并声明兼容 schema v16/v23/v26（environment_fit=2）。
README 结构清晰，含 Quick Start、功能分区、Replay、语言、主题、快捷键、与 TUI 关系、平台支持，信息架构良好（information_architecture=2）。安装步骤具体，含 git clone、install.sh、venv 激活与 zsh 引号注意事项（install_notes=2）。包名、CLI 名、数据目录命名一致（naming_stability=2）。示例仅有截图与一个脱敏 replay JSON，缺少 FAQ 与常见错误排查（examples_and_faq=1）。已知限制仅零散提及 schema 漂移与轮询回退，未集中列出（known_limitations=1）。LICENSE 为完整 MIT 文本且 pyproject 声明 license=MIT，license=3。版本号 0.12.0 存在但无 CHANGELOG 或发布记录（versioning_changelog=1）。维护责任仅指向作者与 Issues 链接，无治理或支持承诺，且发布者身份未经验证（maintenance_responsibility=1）。
输出为浏览器仪表盘，含执行摘要、成本、模型分析、Replay 导出（JSON/Markdown/HTML/PNG），可直接用于分享与 issue 附件，输出可用性较好（output_usability=2）。相对 TUI 增加了 Memory、Skills、Sessions、Replay、Health、Providers、Gateway、Model、Plugins 等标签页与命令面板，边际价值明确（marginal_value=2）。但需同时运行 Hermes agent、Node 22.12+ 与 Python 3.11+，并依赖 ~/.hermes/ 数据，部署与维护成本不低，且未给出性能或资源占用数据，cost_benefit=1。
README 声明“Verified against Hermes Agent v0.20.3（state.db schema v26）”，但仓库内无对应验证脚本、测试输出或版本锁定文件可追溯该声明（claim_traceability=1）。CI 配置与测试文件存在，可部分佐证测试流程，但无独立第三方来源或运行结果佐证功能声明（cross_source_corroboration=1）。README 中事实描述与推断性表述（如“same soul”“popular”）混排，未明确区分已验证事实与营销措辞（fact_inference_separation=1）。
- README 声称已针对 Hermes Agent v0.20.3（state.db schema v26）验证，但仓库内没有可追溯的验证脚本、测试输出或版本锁定文件，该声明目前无法独立核实。
- Python 依赖未提供锁定文件，CI 也未运行 pip-audit 等 Python 依赖漏洞扫描，供应链风险仅由前端 npm audit 与 CodeQL 部分覆盖。
- 除 Health 标签页的 schema 漂移检查外，缺少对 Hermes 缺失、数据目录为空、WebSocket 断连等失败场景的具体错误文案与恢复指引。
- 未描述版本回退、备份或恢复机制；Update hermes 仅显示上次运行日志与状态，回滚能力有限。
- 发布者身份未经验证，维护责任与支持承诺不明确，长期维护与更新路径存在不确定性。
- 远程发布与远程绑定虽默认关闭，但一旦启用需自行承担认证与 TLS 配置责任，README 未提供具体加固步骤。