Hermes Agent: インストール

最終更新:2026-08-31

Hermes Agentのインストールは、学習アシスタントをコンピュータにセットアップするようなものです。一度インストールすれば、いつでも手助けしてくれます。

💡 ヒント: pipインストールが最もシンプルで迅速なセットアップをお勧めします。Dockerはサーバーデプロイに最適。デスクトップ版は非技術ユーザー向けです。

📋 前提知識: 第1課 入門とコア機能

1. 学ぶ内容

# 内容
システム要件と環境チェック
pipインストール(推奨)
ソースコードインストール
Dockerインストール
インストール検証とトラブルシューティング

2. ストーリー

(1) 課題:環境が構築できない

BobはHermes Agentを試したいが、Pythonのバージョンが違う、依存関係の競合、権限の問題...午後ずっとかかっても実行できない。

(2) 解決策:3ステップインストール

Aliceはわずか3ステップで動かしました:

BASH
# 1. 環境チェック
python --version  # Python 3.10+

# 2. ワンコマンドインストール
pip install hermes-agent

# 3. 初期化
hermes init

# 完了!チャット開始
hermes chat

Bobも続いて5分で起動できました。


3. システム要件

(1) 最小要件

コンポーネント 最小 推奨
Python 3.10 3.11以上
RAM 4 GB 8 GB以上
ディスク 2 GB 10 GB以上
OS Linux/macOS/Windows Linux/macOS

(2) 環境チェックスクリプト

BASH
# ワンコマンド環境チェック
curl -sSL https://hermes.dev/check-env.sh | bash
PYTHON
# またはPythonでチェック
import sys
import platform

print(f"Python: {sys.version}")
print(f"Platform: {platform.system()} {platform.release()}")
print(f"Python >= 3.10: {sys.version_info >= (3, 10)}")
💻 出力:

TEXT 📖 参照専用
Python: 3.11.5
Platform: Linux 6.1.0
Python >= 3.10: True

4. インストール方法

(1) pipインストール(推奨)

BASH
# 基本インストール
pip install hermes-agent

# 全プラットフォーム対応
pip install hermes-agent[all]

# 特定のプラットフォームのみ
pip install hermes-agent[telegram,discord]

# GPU加速付き(ローカルモデル推論)
pip install hermes-agent[gpu]

インストール後のCLIツール:

BASH
hermes --version     # バージョン確認
hermes init          # 設定の初期化
hermes chat          # 会話開始
hermes serve         # APIサーバー起動
hermes platform list # 利用可能なプラットフォーム一覧

(2) ソースコードインストール

BASH
# リポジトリをクローン
git clone https://github.com/nous-research/hermes-agent.git
cd hermes-agent

# 仮想環境を作成
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# 依存関係をインストール
pip install -e ".[dev]"

# 検証
hermes --version

(3) Dockerインストール

BASH
# 公式イメージをプル
docker pull nousresearch/hermes-agent:latest

# 実行(インタラクティブチャット付き)
docker run -it \
  -v ~/.hermes:/root/.hermes \
  -e HERMES_MODEL=gpt-4o \
  nousresearch/hermes-agent:latest \
  hermes chat

# docker-composeを使用
curl -O https://hermes.dev/docker-compose.yml
docker-compose up -d
YAML
# docker-compose.yml
version: "3.8"
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    volumes:
      - ./hermes-data:/root/.hermes
    environment:
      - HERMES_MODEL=gpt-4o
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    ports:
      - "8080:8080"
    restart: unless-stopped

5. 初期化

BASH
# インタラクティブ初期化
hermes init

# 初期化時の質問:
? Select default model: gpt-4o
? Enter OpenAI API Key: sk-...
? Select storage location: ~/.hermes
? Enable telemetry: No
? Create example skills? Yes

初期化後のディレクトリ構造:

~/.hermes/
├── config.yaml        # メイン設定ファイル
├── models.yaml        # モデル設定
├── memory/            # メモリストレージ
│   ├── working/       # ワーキングメモリ
│   ├── long_term/     # 長期メモリ
│   └── user_models/   # ユーザーモデル
├── skills/            # スキルストレージ
│   ├── built_in/      # 組み込みスキル
│   └── custom/        # カスタムスキル
├── tools/             # カスタムツール
├── plugins/           # プラグイン
└── logs/              # ログ

6. インストール検証

BASH
# フル検証
hermes doctor

# 出力例:
# ✅ Python 3.11.5
# ✅ Hermes Agent v1.0.0
# ✅ Config file exists
# ✅ Memory system OK
# ✅ Skill engine OK
# ✅ Tools registered: 72
# ✅ Model connection: gpt-4o (OK)
# ✅ Storage space: 8.2 GB available

試してみよう:最初の会話

BASH
hermes chat

> Hello, I'm Hermes!
> I remember information about you (nothing yet, but I'll learn!)
> Try telling me your name and preferences.

me: I'm Alice, I'm a frontend developer, I like TypeScript and React

> Got it! From now on I'll remember:
> - Your name is Alice
> - Frontend developer
> - Prefer TypeScript + React
> What can I help you with?

7. よくあるインストール問題

問題 原因 解決策
pip installが失敗 Pythonバージョンが古い Python 3.10以上にアップグレード
Permission denied システムディレクトリの権限 --userまたは仮想環境を使用
依存関係の競合 他のパッケージとのバージョン競合 venvで分離
Dockerが起動しない Dockerがインストール/実行されていない Docker Desktopをインストール
Invalid API Key キーの期限切れまたはフォーマットエラー config.yamlでキーを確認
メモリ初期化失敗 ディレクトリ権限 chmod 755 ~/.hermes
BASH
# クリーン再インストール
pip uninstall hermes-agent -y
rm -rf ~/.hermes
pip install hermes-agent
hermes init

❓ よくある質問

Q Windowsにインストールできますか?
A はい。HermesはWindows 10/11に対応しています。WSL2またはPowerShell 7以上を推奨。一部機能(Shellツールなど)はWSL2でより動作します。
Q GPUは必要ですか?
A いいえ。GPUはローカルモデル推論(Ollama/vLLM経由)にのみ必要です。クラウドAPIの使用にはGPU不要です。
Q 他のPythonプロジェクトと共存できますか?
A 仮想環境(venv/conda)を使用して依存関係の競合を回避してください。Hermesは他のプロジェクトの依存関係に影響しません。
Q 最新バージョンに更新するには?
A pip install --upgrade hermes-agent。設定ファイルとメモリデータは保持されます。
Q 容量はどれくらい必要ですか?
A 基本インストール約200 MB、依存関係込みで約500 MB。メモリとスキルデータは使用量に応じて増加し、通常月10-50 MB程度です。
Q Raspberry Piで動作しますか?
A Raspberry Pi 4(4GB)で動作可能ですが、クラウドモデルのみ使用可能です。ローカルモデル推論にはより強力なハードウェアが必要です。

📖 まとめ


📝 練習問題

  1. 基本(⭐): コンピュータにHermes Agentをインストールし、hermes doctorを実行してすべての✅を確認してください。
  2. 中級(⭐⭐): Dockerを使用して永続ストレージ付きでHermes Agentをデプロイし、再起動後もデータが保持されることを確認してください。
  3. 上級(⭐⭐⭐): 環境を検出し、インストール方法を選択し、ワンクリックデプロイのために自動設定するインストールスクリプトを書いてください。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%