项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 19482
使用教程
环境要求
- 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
同类项目推荐
hybridclaw
开源
企业自托管 AI 助手，沙箱执行+审批，安全可控
Enterprise-ready self-hosted AI assistant runtime with sandboxed execution, secure c···
Themata-Claude-Scribe
开源
用 Claude 子智能体搭互动故事引擎，长篇剧情不崩人设
Claude Mythos Engine 2026: AI Sub-Agent Framework for Epic Interactive Storytelling
skills
开源
301 个编码技能，让 Claude 智能体秒变领域专家
301 open-source coding agent skills across 22 domains — methodology, judgment & got···
mcp
开源
给 AI 智能体接上数据和工具的标准插座
Enable AI agents to work reliably - giving them secure access to structured data, to···
mcp_agent_mail_rust
开源
用 Rust 打造多智能体协作的 MCP 服务器，通信有序可追溯。
Rust MCP server for multi-agent coordination: 45 tools and 25 resources, Git-backed ···
sandboxd
开源
一条命令自托管，AI 智能体在沙箱里帮你把应用跑起来
Open-source, self-hosted AI app builder — an agent builds real apps in isolated san···
Aivatar-Demo
开源
代码写累了抬头看，AI 伙伴就在桌面上陪你。
Aivatar is a local-first desktop companion for AI coding agents. It turns Codex, Cla···
llm-task-orchestrator
开源
自动分流编码任务，快活交给 Codex，重活用 Claude，省心高效。
Top AI Router 2026: Split Codex for Quick Code & Claude for Complex Refactoring
Athena-Public
开源
本地优先的智能体知识管理，让 AI 用你的数据做决策。
Turn stateless LLMs into a stateful, compounding AI agent. Local-first persistent me···