docker-compose.yml

# Hermes Agent — 默认使用 GitHub Actions 构建并推送到 GHCR 的镜像
#
# 镜像地址与仓库一致（小写）：ghcr.io/<GitHub 用户名或组织>/<仓库名>
# 在 .env 中设置 HERMES_IMAGE（见 .env.example），或与 CI 里 docker/metadata-action 生成的标签一致（如 latest、sha）
#
# 首次拉取（公开仓库可直接拉；私有仓库需先：docker login ghcr.io）：
#   docker compose pull
#
# 环境变量说明（业务「必须」见 .env.example）：
#   · 启动容器：无 API Key 也可
#   · 对话：至少一种 LLM 或在 ./data 下 config
#   · 网关 / 工具：按需
# 更多：https://github.com/NousResearch/hermes-agent/blob/main/.env.example
#
# 准备：cp .env.example .env，填写 HERMES_IMAGE（若与默认 ghcr 路径不一致）及密钥
#
# 常用：
#   docker compose pull && docker compose run --rm hermes
#   docker compose run --rm hermes gateway start
#   docker compose run --rm hermes setup
#
# 若要从本地 Dockerfile 构建而非 GHCR：docker build -f docker/Dockerfile -t hermes-agent:local .
#   再执行：HERMES_IMAGE=hermes-agent:local docker compose run --rm hermes

services:
  hermes:
    image: ${HERMES_IMAGE:-ghcr.io/vxwork/hermes-docker:latest}
    container_name: hermes-agent
    stdin_open: true
    tty: true
    environment:
      HERMES_HOME: /opt/data
      TZ: ${TZ:-Asia/Shanghai}
    env_file:
      - path: .env
        required: false
    volumes:
      - ${HERMES_DATA_HOST:-./data}:/opt/data
    working_dir: /opt/hermes
    command: ["gateway", "start"]