佛系程序员_ hermes-webui的安装

学习笔记

网站开发

发布日期: 2026-06-04 22:16:29

喜欢量: 9 个

阅读次数: 51

目前已运行的 Hermes WebUI 在 `/root/hermes-webui`，以下是安装方式：

---

## 🔧 Hermes WebUI 安装方式

### 方式一：Bootstrap 一键安装（推荐）

```bash
git clone https://github.com/nesquena/hermes-webui.git
cd hermes-webui
python3 bootstrap.py
当前系统 Python 版本＜3.7，语法不兼容报错。
直接调用已有 venv/bin/python3.11 去跑 bootstrap
source /www/wwwroot/hermes-agent/venv/bin/activate
python3 main.py
```

启动：
```bash
./start.sh
```

或使用 `ctl.sh` 管理守护进程：
```bash
./ctl.sh start      # 后台运行
./ctl.sh status     # 查看状态
./ctl.sh stop       # 停止
```

---

### 方式二：Docker 安装（5分钟）

```bash
git clone https://github.com/nesquena/hermes-webui
cd hermes-webui
cp .env.docker.example .env
# 如需密码保护：echo "HERMES_WEBUI_PASSWORD=*** >> .env
docker compose up -d
# 打开 http://localhost:8787
```

---

### 方式三：手动直接启动

```bash
# 使用 hermes-agent 的 venv Python
cd /path/to/hermes-agent
HERMES_WEBUI_PORT=8787 venv/bin/python /path/to/hermes-webui/server.py
```

---

### 📌 关键信息

| 项目 | 说明 |
|------|------|
| 默认端口 | `8787` |
| 默认绑定 | `127.0.0.1`（仅本地） |
| 状态目录 | `~/.hermes/webui/` |
| 默认工作区 | `~/workspace` |
| 密码保护 | 设置环境变量 `HERMES_WEBUI_PASSWORD` |
| 远程访问 | SSH 隧道：`ssh -N -L 8787:127.0.0.1:8787 user@your-server` |

### ⚙️ 常用环境变量

```bash
HERMES_WEBUI_HOST=0.0.0.0              # 允许外部访问
HERMES_WEBUI_PORT=9000                  # 改端口
HERMES_WEBUI_PASSWORD=***           # 密码保护
HERMES_WEBUI_AGENT_DIR=/custom/path    # 指定 agent 路径
HERMES_WEBUI_DEFAULT_WORKSPACE=/mydir  # 默认工作区
```

你的当前 WebUI 已正常运行（端口 8787），是通过方式三手动启动的，用到了 Hermes Agent 的 venv Python。

### webui网页打不开了。解决办法：
回到：
```# 切回hermes-webui项目目录
cd /root/hermes-webui

# 用agent现成的python3.11环境执行安装脚本
/www/wwwroot/hermes-agent/venv/bin/python3 bootstrap.py

source /www/wwwroot/hermes-agent/venv/bin/activate
python3 main.py

./start.sh
```

```# 手动管理命令
systemctl status opencode-serve          # 查看状态
systemctl status opencode-chat-bot       # 查看状态
systemctl stop opencode-chat-bot         # 停止
systemctl restart opencode-serve         # 重启

# 查看日志
journalctl -u opencode-serve -n 50 --no-pager
journalctl -u opencode-chat-bot -n 50 --no-pager
```

admin

https://www.amtb.info/show/NDE2

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !