Hermes Agent Docker: 2026 年の完全な導入ガイド

2 つの Docker モードの説明 — 始める前に選択してください

ほとんどのガイドはこの決定を完全にスキップし、docker run にジャンプします。やめてください。 2 つのモードには、セキュリティと運用プロファイルが大幅に異なります。

Mode 1 — コンテナ内で走るエルメス

ヘルメスとそのすべての依存関係はイメージ内に存在します。名前付きボリュームを介して状態を管理します。コンテナーの再起動ポリシーにより、コンテナーは再起動後も存続します。これが最も一般的な生産パターンです。

• ホストから完全に分離 - マシンへの誤った書き込みはありません
• 完全な携帯性。同じ構成ファイルを使用してどこにでも再デプロイ
• ネイティブで実行するよりもオーバーヘッドがわずかに高い

モード 2 — ターミナル バックエンド サンドボックスとしての Docker

ここで、Hermes はホスト上 (またはコンテナー内) で直接実行され、Docker デーモンを呼び出して、シェル実行用の一時的なコンテナーをスピンアップします。 DOCKER_HOST を設定して構成すると、Hermes がデーモンにアクセスできるようになります。

export DOCKER_HOST=unix:///var/run/docker.sock   # Linux
export DOCKER_HOST=tcp://host.docker.internal:2375  # Windows/Mac (Docker Desktop)

前提条件と環境セットアップ

イメージを取得する前に、次のことを確認してください。

• Docker Engine 24+ または Docker Desktop 4.26+
• 準備ができている LLM API キー: OpenAI (OPENAI_API_KEY)、Anthropic (ANTHROPIC_API_KEY)、またはローカル Ollama エンドポイント
• ポート 443 でのアウトバウンド インターネット アクセス (LLM API 呼び出し用)
• 少なくとも 2 GB RAM コンテナに割り当てられます (Ollama を利用したセットアップには 4 GB を推奨)

Windows 固有のセットアップ (Docker デスクトップ + WSL2)

Windows は、ほとんどの Docker デプロイメントが静かに壊れる場所です。以下に注意してください。

# Correct — Docker Desktop translates this automatically
volumes:
  - hermes_data:/root/.hermes

DOCKER_HOST=npipe:////./pipe/docker_engine

[wsl2]
memory=4GB
processors=2

クイック スタート — 5 分で Docker を使用して Herme エージェントを実行する

公式イメージを取得し、セットアップ ウィザードを実行します。

# Pull the latest image
docker pull nousresearch/hermes-agent:latest

# Run with a persistent volume for state
docker run -it \
  -v hermes_home:/root/.hermes \
  -e OPENAI_API_KEY=your_key_here \
  nousresearch/hermes-agent:latest

の セットアップウィザード 最初の実行時に起動します。次のことを求めるプロンプトが表示されます。

1. LLM プロバイダー (OpenAI、Anthropic、Ollama、またはカスタム エンドポイント) を選択します。
2. API キーまたはエンドポイント URL を入力してください
3. ターミナル バックエンド (ネイティブまたは Docker サンドボックス) を構成する

完了したら、セッションが機能していることを確認します。

> hello

Docker Compose を使用した本番環境へのデプロイメント

裸の docker run コマンドはテストに機能します。永続的なものについては、Compose を使用します。

version: "3.9"

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-agent
    restart: unless-stopped
    stdin_open: true
    tty: true

    environment:
      # Use environment secrets — never hardcode keys in compose files
      OPENAI_API_KEY: ${OPENAI_API_KEY}
      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
      HERMES_LOG_LEVEL: info

    volumes:
      - hermes_home:/root/.hermes         # Config + conversation history
      - hermes_skills:/root/.hermes/skills # Skill store — see next section

    deploy:
      resources:
        limits:
          memory: 2G
          cpus: "1.5"

    healthcheck:
      test: ["CMD", "hermes", "--health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 15s

    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

volumes:
  hermes_home:
  hermes_skills:

API キーを .env ファイルに保存します (バージョン管理には決してコミットしません)。

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

コンテナの再構築後も Herme のスキルを維持する

これは、生産上最も見落とされている懸念事項です。エルメスストアは、一般的な構成とは別にスキルを学習しました。これらのパスを明示的にマウントします。

イメージを更新するとき:

docker compose pull
docker compose up -d   # Named volumes persist automatically

高度なトポロジ — ホスト-Docker (兄弟コンテナ) セットアップ

このアーキテクチャは、Hermes で兄弟コンテナを調整してコードを分離して実行する場合 (たとえば、ユーザーが送信したコードを安全に実行する場合) に使用されます。

┌─────────────────────────────────┐
│         Docker Host             │
│                                 │
│  ┌──────────────┐               │
│  │ hermes-agent │◄──socket──────┤── /var/run/docker.sock
│  │  container   │               │
│  └──────┬───────┘               │
│         │ docker run (sibling)  │
│  ┌──────▼───────┐               │
│  │  sandbox-1   │  (ephemeral)  │
│  └──────────────┘               │
└─────────────────────────────────┘

このトポロジの構成を作成します。

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    restart: unless-stopped
    environment:
      OPENAI_API_KEY: ${OPENAI_API_KEY}
      DOCKER_HOST: unix:///var/run/docker.sock
      HERMES_TERMINAL_BACKEND: docker
    volumes:
      - hermes_home:/root/.hermes
      - /var/run/docker.sock:/var/run/docker.sock  # Socket mount
    group_add:
      - "999"   # docker group GID — adjust to match your host

Telegram ボット経由でエルメスを Claude に接続する

No の書面によるガイドでは現在これについて説明していますが、ビデオ形式でのみ示されています。これが完全なセットアップです。

/newbot
→ Name: Hermes Agent
→ Username: your_hermes_bot
→ Save the token: 123456:ABC-DEF...

environment:
  ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
  HERMES_LLM_PROVIDER: anthropic
  HERMES_TELEGRAM_TOKEN: ${TELEGRAM_BOT_TOKEN}
  HERMES_TELEGRAM_ALLOWED_USERS: "your_telegram_user_id"

docker compose up -d

マルチアーキテクチャ導入 (ARM64 / Oracle 無料利用枠 / Raspberry Pi)

nousresearch/hermes-agent イメージはマルチ アーキテクチャ マニフェストとして出荷されます。 ARM64 がサポートされています - ARM ホスト上で明示的にプルします。

# Oracle Free Tier (Ampere A1) or Raspberry Pi 4/5
docker pull --platform linux/arm64 nousresearch/hermes-agent:latest

# Verify the architecture
docker inspect nousresearch/hermes-agent:latest | grep Architecture

ARM 固有の既知の問題:

• 一部の Ollama モデルの量子化 (Q8) は、ARM では実行速度が遅くなります。ローカル推論には Q4_K_M を優先します
• exec format error を押した場合は、--platform linux/arm64 フラグを使用していることを確認してください
• Apple Silicon 上の Docker デスクトップは ARM をネイティブに処理します - プラットフォーム フラグは必要ありません

一般的なHermes Agent Docker障害のトラブルシューティング

発生する可能性が最も高い障害の参照表:

よくある質問

最終的な考え: チェックリストと次のステップ

学習ループは、Hermes を Docker で実行した他のエージェントと区別するものです。上記の設定により、ループが実際に実行されることが保証されます 蓄積する — リセットではありません — アップデートを出荷するたびに。

デプロイメントを本番対応と呼ぶ前に、次のことを確認してください。

• ☐ hermes_home と hermes_skills の両方に対して作成された名前付きボリューム
• ☐ API キーは .env に保存され、Compose にハードコーディングされていません
• ☐ restart: unless-stopped ポリシーがアクティブです
• ☐ ヘルスチェックに合格しました: docker inspect hermes-agent --format='{{.State.Health.Status}}'
• ☐ ログローテーションの構成 (max-size、max-file)
• ☐ メモリの枯渇を防ぐために設定されたリソース制限
• ☐ セットアップ ウィザードが完了し、最初のチャット セッションが検証されました
• ☐ (Mode 2 の場合) Docker ソケットのマウントが確認され、ソケット プロキシが考慮されます

値をすぐに取得するための次のステップ:

1. いくつかの実際のタスク (ファイルの要約、コード レビュー、Web 調査) を実行して、スキル ライブラリをシードします。
2. 10 ～ 15 のタスクの後、hermes skills list を実行して学習内容を確認します。
3. カスタム スキル テンプレートとメモリ調整をカバーするエージェント構成ドキュメントについては、Nous Research GitHub を参照してください。
4. Oracle 無料利用枠を利用している場合は、学習した状態を維持しながらダウンタ​​イムなしでイメージを更新できるように cron ベースの docker compose pull && docker compose up -d をセットアップします。