hermes-webui

浏览器/手机直接用 Hermes Agent，无需命令行

Hermes WebUI 是 Nous Research 推出的 Hermes Agent 的官方 Web 界面，让你在浏览器或手机上就能轻松使用 Hermes Agent。它解决了命令行工具使用门槛高、移动端不便的问题，将强大的 AI 智能体能力封装成直观的图形界面。核心能力包括：与 Hermes Agent 进行多轮对话、管理多个 Agent 会话、查看任务执行日志与结果、支持文件上传与下载，以及通过响应式设计适配手机屏幕。用户无需安装或掌握复杂命令，即可通过 Web 界面调用 Hermes Agent 的规划、工具调用和代码执行等能力，适合快速体验和日常使用。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 18522

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队nesquena

所属国家

官网地址https://get-hermes.ai/setup

GitHubhttps://github.com/nesquena/hermes-webui

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,ai-agents,hermes,hermes-agent,nous-research

GitHub 星标★ 18522

30天Star增速

HF 下载量

上线时间2026-03-30 00:00:00

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

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

环境要求

Python 3.11 / 3.12 / 3.13（README 明确支持的解释器版本）
git（用于克隆仓库）
已配置好的 Hermes Agent 环境（WebUI 会直接读取 HERMES_HOME 配置）
本机 8787 端口可用（默认 Web 访问端口）

安装与启动步骤

1克隆仓库

把官方仓库克隆到本地 hermes-webui 目录，需要已安装 git 并能访问 GitHub。
```
git clone https://github.com/nesquena/hermes-webui.git hermes-webui
```
2进入项目目录

后续所有启动脚本都要在仓库根目录下执行。
```
cd hermes-webui
```
3运行引导脚本

README 推荐的快速启动方式，前台运行；想停止直接在终端按 Ctrl-C。也可以改用 ./start.sh 启动器。
```
python3 bootstrap.py
```
4后台守护启动

自托管长期运行用它；PID 写入 ~/.hermes/webui.pid，日志写入 ~/.hermes/webui.log。
```
./ctl.sh start
./ctl.sh status
./ctl.sh logs --lines 100
```

5Docker 方式运行

官方镜像已发布到 GHCR，单容器内进程内运行 agent；注意把 ~/.hermes 状态目录挂载进去。

docker pull ghcr.io/nesquena/hermes-webui:latest
docker run -d -e WANTED_UID=$(id -u) -e WANTED_GID=$(id -g) -v ~/.hermes:/home/hermeswebui/.hermes -e HERMES_WEBUI_STATE_DIR=/home/hermeswebui/.hermes/webui -v ~/workspace:/workspace -p 127.0.0.1:8787:8787 ghcr.io/nesquena/hermes-webui:latest

关键配置

配置项	必填	说明	示例
`HERMES_WEBUI_HOST`	否	绑定监听的地址，改成 0.0.0.0 可让局域网内其他设备访问	`0.0.0.0`
`HERMES_WEBUI_STATE_DIR`	否	WebUI 状态数据目录，Docker 场景常用	`/home/hermeswebui/.hermes/webui`
`HERMES_WEBUI_CHAT_BACKEND`	否	设为 gateway 时通过 Hermes Gateway API 路由对话	`gateway`
`HERMES_API_URL`	否	只被 Tasks/cron 健康探测读取，不用于路由聊天	`http://127.0.0.1:8642/v1`
`HERMES_WEBUI_TEST_PYTHON`	否	创建仓库 .venv 时指定的 Python 解释器路径	`/path/to/python3.12`

如何确认成功

浏览器打开 http://127.0.0.1:8787 看到三栏界面即成功；或执行 ./ctl.sh status 查看 PID、端口与 /health。

常见问题

Q：怎么停止服务？

A：python3 bootstrap.py 启动的在终端按 Ctrl-C；./ctl.sh start 启动的用 ./ctl.sh stop；start.sh 或游离 bootstrap 进程可用 lsof -i :8787 找到 PID 后 kill。

Q：为什么 ./ctl.sh stop 停不掉服务？

A：ctl.sh 只能管理它自己启动的进程。由 bootstrap.py 或 start.sh 直接启动的服务没有写入 PID 文件，需要手动查端口找进程结束。

Q：WebUI 会连外部 API 服务器来聊天吗？

A：不会。WebUI 在进程内运行 Hermes agent，直接读取 HERMES_HOME 配置；HERMES_API_URL 只用于 Tasks/cron 健康探测。

Q：想用外部 OpenAI 兼容端点怎么办？

A：在 Settings → Providers 里添加自定义 OpenAI 兼容 provider，base_url 填 http://127.0.0.1:8642/v1 并填入你的 bearer token。

Q：怎么在手机或别的设备上访问？

A：用内联覆盖把监听地址放开，例如 HERMES_WEBUI_HOST=0.0.0.0 ./ctl.sh start，然后从同一网络的设备访问主机 IP:8787。

注意事项

README 明确说明 WebUI 无构建步骤、无框架、无打包器，只需 Python 和原生 JS。
ctl.sh 不依赖 fuser 或 pkill，适合自托管 VM 或 homelab 环境。
配置可写在 .env 中，也可用 HERMES_WEBUI_HOST=0.0.0.0 ./ctl.sh start 这种内联方式覆盖。
Docker 快速开始涉及的 compose 启动命令 README 节选中未给出完整命令，请参考 docs/docker.md。

核心亮点

官方出品，与 Hermes Agent 深度集成，功能同步更新
响应式设计，手机浏览器也能流畅操作
提供会话管理和日志查看，便于追踪 Agent 行为

不足之处

依赖 Hermes Agent 后端，需自行部署或配置服务
文档/社区待观察

适用场景

在手机上随时与 AI 助手对话并执行任务
团队通过 Web 界面共享使用 Hermes Agent 能力
快速演示或体验 Hermes Agent 功能而不装 CLI

替代项目

Open WebUI、LibreChat、Lobe Chat

项目介绍

hermes-webui 是智能体领域的开源项目，由 nesquena 开发，是 2026 年新上线的项目。

在全站 13,109 个收录项目中，它的 GitHub 星标数（18,522）位列前 3%，在智能体分类的 2,520 个项目里位列前 4%。

近 41 天，它的 GitHub 星标从 17,265 增加到 18,522，净增 1,257。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：在手机上随时与AI助手对话并执行任务。同类可对比的替代方案包括 Open WebUI、LibreChat、Lobe Chat。

上一篇：Equibles

下一篇：caracal