Sign inSign up

ocpub/oc9-hermes

By ocpub

•Updated 4 months ago

Image
0

90

ocpub/oc9-hermes repository overview

⁠Hermes Agent 0.14.0 on OpenCloudOS 9

⁠基本信息

  • 框架版本：v0.14.0（上游 tag: v2026.5.16）
  • 基础镜像：opencloudos9-minimal:latest
  • Python 版本：3.11.6
  • CUDA 版本：N/A
  • 镜像大小：~1.38GB

⁠简介

Hermes Agent 是 NousResearch 开发的自我改进 AI Agent，能够从经验中创建技能并在使用过程中改进，支持多种 LLM 提供商和 22+ 种消息平台。

本镜像基于 OpenCloudOS 9 minimal 构建，适用于 CPU 环境。

⁠构建

docker build -t oc9-hermes:0.14.0 .

⁠使用说明

详细的官方 Docker 使用文档请参考： https://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/docker⁠

⁠快速开始（首次运行设置）

创建数据目录并运行设置向导（只需执行一次）：

mkdir -p ~/.hermes
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  oc9-hermes:0.14.0 \
  hermes setup

设置向导会提示输入 API 密钥并将其写入 ~/.hermes/.env。

⁠交互式 CLI 聊天

对已有数据目录打开交互式聊天会话：

docker run -it --rm \
  -v ~/.hermes:/opt/data \
  oc9-hermes:0.14.0
⁠以 Gateway 模式运行

配置完成后，将容器作为持久化 gateway（Telegram、Discord、Slack、WhatsApp 等）在后台运行：

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  oc9-hermes:0.14.0 \
  hermes gateway run

端口 8642 暴露 gateway 的 OpenAI 兼容 API 服务器和健康检查端点。

启用 API 服务器（需设置 API_SERVER_KEY）：

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  -e API_SERVER_ENABLED=true \
  -e API_SERVER_HOST=0.0.0.0 \
  -e API_SERVER_KEY="$(openssl rand -hex 32)" \
  -e API_SERVER_CORS_ORIGINS='*' \
  oc9-hermes:0.14.0 \
  hermes gateway run

查看 gateway 状态：

docker exec hermes hermes gateway status
⁠运行 Dashboard

内置 Web dashboard 作为可选的子进程运行。设置 HERMES_DASHBOARD=1 可在启动 gateway 时同时启动 dashboard：

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  -e HERMES_DASHBOARD=1 \
  oc9-hermes:0.14.0 \
  hermes gateway run

Dashboard 环境变量：

变量描述默认值
HERMES_DASHBOARD设为 1 以启动 dashboard未设置
HERMES_DASHBOARD_HOST绑定地址127.0.0.1
HERMES_DASHBOARD_PORTHTTP 端口9119
HERMES_DASHBOARD_TUI设为 1 启用浏览器内 Chat 标签页未设置

查看 dashboard 状态：

docker exec hermes hermes dashboard --status
⁠验证安装
# 查看版本
docker run --rm oc9-hermes:0.14.0 hermes version

# 运行诊断
docker run --rm -e HERMES_HOME=/tmp/hermes_test oc9-hermes:0.14.0 \
  hermes doctor

# 查看整体状态
docker run --rm oc9-hermes:0.14.0 hermes status

⁠数据持久化

容器将所有用户数据（配置、API 密钥、会话、技能、记忆）存储在 /opt/data 目录中。通过 -v ~/.hermes:/opt/data 挂载宿主机目录实现数据持久化。镜像本身是无状态的，可通过拉取新版本进行升级而不会丢失任何配置。

⁠已知问题

  • （暂无）

Tag summary

Content type

Image

Digest

sha256:fd7df1e6a…

Size

321.2 MB

Last updated

4 months ago

docker pull ocpub/oc9-hermes:0.14.0