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)で動作可能ですが、クラウドモデルのみ使用可能です。ローカルモデル推論にはより強力なハードウェアが必要です。
📖 まとめ
- 3つのインストール方法:pip(推奨)、ソースコード、Docker
- pipワンライナー:
pip install hermes-agent[all] hermes initでインタラクティブセットアップ、ディレクトリ構造を自動作成hermes doctorでインストール成功を検証- 仮想環境で依存関係の競合を防止、Dockerはサーバーデプロイ向け
📝 練習問題
- 基本(⭐): コンピュータにHermes Agentをインストールし、
hermes doctorを実行してすべての✅を確認してください。 - 中級(⭐⭐): Dockerを使用して永続ストレージ付きでHermes Agentをデプロイし、再起動後もデータが保持されることを確認してください。
- 上級(⭐⭐⭐): 環境を検出し、インストール方法を選択し、ワンクリックデプロイのために自動設定するインストールスクリプトを書いてください。