hermes-hudui

给持久记忆 AI 智能体装一块实时意识仪表盘

hermes-hudui 是 Hermes 智能体的 Web 可视化监控面板。Hermes 是一个具备持久记忆能力的 AI 智能体，会持续积累对话、任务与内部状态，但记忆和意识流藏在后台难以观察。本项目通过浏览器界面实时展示 Hermes 的记忆内容、运行状态与内部活动，相当于给智能体装了一块「意识仪表盘」。它解决的核心问题是：持久记忆型智能体行为不透明，开发者难以判断它记住了什么、当前在想什么、是否出现记忆污染或状态异常。核心能力包括：实时刷新智能体状态、浏览与检索持久记忆条目、可视化内部活动流，并支持在本地以 Python 服务方式快速启动。适合调试、演示和日常运维 Hermes 的开发者使用。

开源 free 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1844

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类基础设施

开发团队joeynyc

所属国家

官网地址

GitHubhttps://github.com/joeynyc/hermes-hudui

定价模式free

价格说明开源免费，需自行部署

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型

GitHub 星标★ 1844

30天Star增速

HF 下载量

上线时间2026-04-09 00:00:00

最近更新2026-09-21 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-22

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

Python 3.11 及以上
Node.js 22.12 及以上
已安装并在运行的 Hermes 智能体，数据位于 ~/.hermes/
与 Hermes Agent v0.20.3（state.db schema v26）匹配，兼容 schema v16 与 v23

安装与启动步骤

1克隆项目仓库

把 hermes-hudui 源码下载到本地，确保网络可访问 GitHub。
```
git clone https://github.com/joeynyc/hermes-hudui.git
```
2进入目录并安装

运行仓库自带的一键安装脚本，它会完成依赖安装等准备工作，耗时视网络而定。
```
cd hermes-hudui
./install.sh
```
3启动 HUD 服务

安装完成后直接执行命令启动面板，默认监听本地 3001 端口。
```
hermes-hudui
```
4浏览器访问面板

用浏览器打开 http://localhost:3001，即可看到 Hermes 的记忆与运行状态仪表盘。
5后续再次启动

以后重新启动时先激活虚拟环境再运行，无需重复执行安装脚本。
```
source venv/bin/activate && hermes-hudui
```

关键配置

配置项	必填	说明	示例
`~/.hermes/`	是	Hermes 智能体的数据目录，HUD 从这里读取记忆与状态数据	`~/.hermes/`

如何确认成功

浏览器打开 http://localhost:3001 能正常显示仪表盘各标签页，说明启动成功。

常见问题

Q：浏览器打不开 http://localhost:3001 怎么办？

A：确认命令已成功启动且服务在运行，并检查 Hermes 智能体是否正在运行、~/.hermes/ 下是否存在数据；HUD 直接读取该目录与 hermes CLI。

Q：下次使用还要重新安装吗？

A：不需要。进入项目目录后执行 source venv/bin/activate && hermes-hudui 即可再次启动。

Q：面板显示的数据和智能体不一致怎么办？

A：开启 Health 标签页，查看 Agent data layout 与 Agent schema version 检查项，判断你的 Hermes 数据是否偏离 v0.20.3/schema v26 基线。

Q：支持哪些 Hermes 版本？

A：README 说明已针对 Hermes Agent v0.20.3（state.db schema v26）验证，并保留对 schema v16 和 v23 的兼容。

注意事项

必须已有可用的 Hermes 智能体及其 ~/.hermes/ 数据，HUD 本身不产生数据。
HUD 直接读取 ~/.hermes/ 与 hermes CLI，因此会跟随智能体的磁盘布局变化。
面板默认端口为 3001，README 未提供修改端口的说明。
安装脚本会创建 venv 虚拟环境，后续启动需先激活该环境。

核心亮点

把 Hermes 的持久记忆和内部状态做成可视化界面，调试时不用再翻日志或数据库
基于 Python，本地即可启动 Web 服务，接入现有 Hermes 实例成本低
实时展示智能体活动流，便于发现记忆异常或状态漂移

不足之处

强绑定 Hermes 生态，脱离该智能体基本无用
项目较新、星标量有限，文档与社区案例待观察

适用场景

调试 Hermes 智能体时观察它记住了哪些信息
向他人演示持久记忆智能体时展示其内部意识流
日常运维中监控智能体状态是否异常

替代项目

Langfuse、Phoenix (Arize)

项目介绍

hermes-hudui 是基础设施领域的开源项目，由 joeynyc 开发，是 2026 年新上线的项目。

在全站 12,909 个收录项目中，它的 GitHub 星标数（1,844）位列前 30%，在基础设施分类中处于中上游。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-21。开源免费，需自行部署。

它主要面向的使用场景是：调试Hermes智能体时观察它记住了哪些信息。同类可对比的替代方案包括 Langfuse、Phoenix (Arize)。

上一篇：console

下一篇：airbyte