---
title: hermes_computer
canonical_url: "https://www.modelscope.cn/studios/conanholmes/hermes_computer"
md_url: "https://www.modelscope.cn/studios/conanholmes/hermes_computer.md"
repository: conanholmes/hermes_computer
chinese_name: hermes_agent_back1003
last_updated: 2026-10-03
sdk_type: docker
sdk_version: 6.17.3
downloads: 0
stars: 1
---

# hermes_computer

> hermes_computer - conanholmes 在 ModelScope 创建的在线 Demo。hermes_agent_back1003

conanholmes/hermes_computer 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 docker 6.17.3 构建，中文名为「hermes_agent_back1003」。

- **Repository**: conanholmes/hermes_computer
- **SDK**: docker
- **SDK version**: 6.17.3
- **Downloads**: 0
- **Stars**: 1
- **Last updated**: 2026-10-03

Source: https://www.modelscope.cn/studios/conanholmes/hermes_computer

---

# hermes-webui-cn × ModelScope 创空间（Docker 全家桶）

把 **Hermes WebUI（中文版）+ hermes-agent** 整个塞进一个创空间容器。
上传到创空间的只有 5 个文件；WebUI 与 Agent 源码在**构建期**自动 clone。

- WebUI 上游：`Eynzof/hermes-webui-cn`（默认走 cnb.cool 国内镜像）
- Agent 上游：`NousResearch/hermes-agent`
- 对外端口：**7860**（ModelScope docker 类型硬性要求）
- 鉴权：**nginx HTTP Basic Auth**（前置网关，与 hermes-agent 网关/仪表盘认证完全无关）

```
modelscope-space/
├── Dockerfile      # 构建期完成全部安装
├── ms_deploy.json  # sdk_type=docker, 端口 7860, 2v-cpu-16g
├── entrypoint.sh   # 启动时用环境变量生成密码文件 → 起 nginx + WebUI
├── nginx.conf      # 7860 端口 Basic Auth 网关，代理到内网 WebUI
└── README.md
```

## 一、创建并推送创空间

1. 打开 <https://www.modelscope.cn/studios> → **创建创空间**，类型选 **Docker**
2. 本地推送（仓库地址在创空间页面复制）：

   ```bash
   git init
   git add Dockerfile ms_deploy.json README.md entrypoint.sh nginx.conf
   git commit -m "init"
   git remote add origin https://www.modelscope.cn/git/<你的用户名>/<空间名>.git
   git push -u origin master
   ```

   首次推送触发构建：clone 两个仓库 + 装依赖，约 5~15 分钟。

## 二、设置密钥环境变量（必须在创空间控制台配）

构建完成后，到创空间 **设置 → 环境变量**，把以下项加为 **secret**：

| 变量 | 说明 |
|---|---|
| `AUTH_USERNAME` | 可选，登录用户名（不设默认 `admin`） |
| `AUTH_PASSWORD` | **登录密码**。nginx Basic Auth 用它，没有它也会起（随机生成并打印到日志），但务必设置 |
| `ANTHROPIC_API_KEY` | 你实际用的 provider 的 key（以下按需取） |
| `OPENAI_API_KEY` / `DASHSCOPE_API_KEY` / `DEEPSEEK_API_KEY` … | 用哪个 provider 配哪个，agent 直接读环境变量 |

> 所有密钥不进仓库、不进镜像层，容器启动时才注入。
> 修改后按平台提示重启生效。

## 三、访问与登录

1. 打开空间地址，**浏览器会弹 HTTP Basic Auth 框**，输入 `AUTH_USERNAME` / `AUTH_PASSWORD`。
2. 通过后进入 WebUI，首次使用走一次 onboarding 向导选 provider/模型（写入容器内 `~/.hermes/config.yaml`）。
3. 之后每次打开弹一次 Basic Auth（浏览器通常记住会话）。

**鉴权层级说明**：外部 → nginx(7860, Basic Auth) → WebUI(127.0.0.1:8787，无独立密码)。
不设置 `HERMES_WEBUI_PASSWORD`，也不使用 hermes gateway 的 `API_SERVER_KEY`/仪表盘账号，
因此不存在"官方网关鉴权登录不进去"的问题——那一层根本没启用。
唯一放行的路径是 `/health`（平台探活用）。

## 四、注意事项

- **重启/重新部署后容器文件系统可能重置**（创空间 docker 类型无持久化卷保证）。
  会话历史、`~/.hermes/config.yaml` 可能丢，密钥在环境变量里不会丢——丢了配置就重新走向导。
- **provider SDK 懒安装**：`[all]` 不含 provider SDK（如 anthropic），首次选该 provider 时自动装
  （走 tsinghua PyPI 镜像）。想预装就改 Dockerfile 的 `AGENT_EXTRAS`（空格/逗号分隔均可），重新 push。
- **"检查更新"按钮**：基于容器内 git origin（构建时 clone 的 cnb/GitHub），可用；重新部署会回到最新版。
- **改配置**：`AGENT_REPO` / `WEBUI_REPO` / `AGENT_EXTRAS` 在 Dockerfile 里改默认值后重新 push 触发重建。
- **资源档**：`ms_deploy.json` 默认 `platform/2v-cpu-16g-mem`，不够用可换（在创空间页面配置）。

## 五、故障排查

- 构建卡在 clone → 看构建日志；`AGENT_REPO` 走 GitHub，Dockerfile 内置 ghproxy 兜底。
- 构建失败在 `uv pip install ... hermes-agent` 且报 "Building wheels or sdists ... is not supported"
  → 必须用可编辑安装（Dockerfile 里已经是 `-e`），这是 agent 官方唯一支持的源码安装方式。
- 访问空间一直 401 → 说明 nginx 正常，密码不对；核对 `AUTH_PASSWORD` 是否已在控制台配置并重启。
- 容器起不来 / 一直重启 → 看运行日志，确认 `/health` 是否 200（健康检查打的是内网 8787）。
- 登录后报"未配置模型/provider" → 环境变量里 provider key 没配，或首次向导没走完。