Hermes Web UI

Hermes Web UI 是专为 Hermes Agent（NousResearch 开源的多平台 AI Agent 框架）设计的全功能 Web 管理面板。

• 核心价值：解决了 Hermes 原生命令行界面（CLI）操作繁琐的痛点，将聊天会话管理、渠道配置、成本监控等能力封装进现代化的响应式 Web 界面中。
• 技术栈：基于 Vue 3 + Koa 2 构建，采用 MIT 协议开源。

1 安装方式

npm install -g hermes-web-ui

查看是否安装成功：

hermes-web-ui --version

若显示-bash: hermes-web-ui: command not found，则排查被安装到哪个目录：

npm list -g hermes-web-ui

根据输出的内容，例如

将其加入path

# 1. 获取 npm 的全局前缀路径（通常就是 Node.js 的安装根目录）
npm config get prefix
# 预期输出类似：/usr/local/node-v24.14.1-linux-arm64

# 2. 将对应的 bin 目录添加到 ~/.bashrc（如果你用的是 bash）
echo 'export PATH="/usr/local/node-v24.14.1-linux-arm64/bin:$PATH"' >> ~/.bashrc

# 3. 立即生效（重新加载配置）
source ~/.bashrc

配置完成后，请验证命令是否可用：

hermes-web-ui --version
# 预期输出：0.5.11 或类似版本号

2 启动hermes gateway

若配置vpn，需先启动vpn，之后

hermes gateway run

3 启动ui

使用环境变量 HOST=0.0.0.0让服务监听所有网络接口，这样局域网设备才能连接：

HOST=0.0.0.0 hermes-web-ui start

端口可选：如果你想换端口（如 9000），可以加在命令末尾：HOST=0.0.0.0 hermes-web-ui start 9000，默认为8648

hermes-web-ui默认启用 Token 认证，启动后 Token 会自动生成在日志文件中。会在启动成功后显示

或在服务器上执行以下命令查看：

cat ~/.hermes-web-ui/server.log | grep -i token

在同一局域网下的电脑/手机浏览器中打开：

http://<服务器IP地址>:8648/#/?token=<刚才获取的Token>

之后即可使用

方便查看历史对话，用量等信息。安装后可使用以下命令管理后台服务：

• hermes-web-ui stop：停止服务。

• hermes-web-ui restart：重启服务。

• hermes-web-ui status：查看运行状态。

• hermes-web-ui update：更新至最新版本。