Hermes Agent インストール方法

日付:

シンプルなテキストをやり取りするチャットボットの時代は終わりました。今は、私のPC のファイルを直接編集し、ブラウザを開いて情報を検索し、必要な技術を自分でコーディングして保存するエージェントの時代です。その中心にいる Hermes Agent は、ユーザーの意図を理解して実行可能なコードを抽出する能力が優れています。初心者でも滞りなく自分のエージェントを構築できるように、インストールから実践的な活用まで、すべてのプロセスを非常に詳しくガイドしていきます。




Terminal準備とローカル環境構築戦略


インストールを始めるには、コマンドを入力する Terminal 環境が必要です。macOS ユーザーは Spotlight(Cmd+Space)で Terminal を検索して実行すればよく、Windows ユーザーは PowerShell を管理者権限で開き、wsl --install コマンドで WSL2 をまずインストールする必要があります。Linux 環境なら Ctrl+Alt+T を押して即座にターミナルを呼び出せます。


最初に確認すべきツールは Git です。Terminal に git --version を入力したときにバージョン情報が出ない場合は、各 OS に合わせたインストールプロセスを進める必要があります。Git が準備できたら、以下のワンライナースクリプトで Python や Node.js などすべての依存関係を自動インストールできます。


# 1. Git インストール確認（ない場合は https://git-scm.com/ からインストール）
git --version

# 2. ワンライナー インストールスクリプト実行
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 3. 環境変数適用（コマンドが見つからない場合は実行）
source ~/.bashrc


パッケージ管理をより速く、効率的にしたい上級ユーザーは uv を使ってみてください。uv は非常に高速な Python パッケージマネージャーで、以下のコマンドで Hermes をクリーンな隔離環境にインストールできます。


# uv インストールおよび Hermes インストール
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install -e ".[all]"


  • Terminal 実行および OS 別 WSL2/環境変数チェック
  • Git インストール確認によるソースコード管理基盤確保
  • 自動インストールスクリプトで Python および Node.js 依存関係一括解決
  • uv パッケージマネージャーを活用した高性能インストールオプション提供
  • インストール後 hermes コマンド実行による正常動作判別
  • エラー発生時 source コマンドまたはターミナル再起動試行


Model接続のための OpenRouter と API Key 発行


エージェントが賢く思考するには、脳の役割を果たす LLM(大型言語モデル)を接続する必要があります。2026年現在、最も推奨される方法は OpenRouter(https://openrouter.ai/)を使用することです。ホームページ右上の Sign Up ボタンを押してサインアップし、Keys メニューで Create Key をクリックして自分の API Key を発行してください。


OpenRouter は1つの Key で Claude 3.5 Sonnet、GPT-4o、Llama 3 など数百のモデルを自由に切り替えながらテストできるため、初心者に最適です。最初の 1～2 週間は複数のモデルを試して、自分に合った脳を見つけてみてください。特定のモデルに定着したら、後でそのサービス(例：Anthropic)に直接登録して API を接続すれば、約 10% 程度の手数料を削減しながらより高速に利用できます。


コスト比較（1M tokens 基準の例）:
- OpenRouter 経由 Claude：約 $3.00（利便性手数料含む）
- Anthropic API 直接接続：約 $2.70（直接管理が必要）


メッセンジャー連携を希望する場合は、Telegram の @BotFather 経由で Bot Token も発行する必要があります。/newbot コマンドでボットを作成し、受け取った Token をメモしておいてください。この Token さえあれば、スマートフォンの Telegram アプリからも自分のエージェントに業務を指示できます。


  • OpenRouter 登録および統合 API Key 発行プロセス
  • 使用目的に応じた最適な LLM(Claude、GPT など)探索
  • テスト期間を経た後、直接 API 接続によるコスト最適化
  • Telegram @BotFather を活用した外部制御用ボット作成
  • 各プラットフォーム別 API 使用量監視および残高管理
  • セキュリティのための Secret Key の安全な別保管


config.yaml完全ガイドとセキュリティ設定


Agent のすべての設定は config.yaml ファイルで行われます。YAML 形式はインデント(字下げ)が生命なので、タブではなく必ずスペースバー 2 マスを使う必要があります。初心者なら Terminal の nano エディターより VS Code(コマンド code ~/.hermes/config.yaml)を使う方がはるかに安全です。以下はセキュリティと拡張性の両方を考慮した設定例です。


# ~/.hermes/config.yaml フル設定例
model:
  provider: openrouter
  api_key: ${OPENROUTER_API_KEY}  # 環境変数使用を推奨
  model: anthropic/claude-sonnet-4

terminal: local              # VPS 運用時、セキュリティのため docker に変更推奨

gateway:
  telegram:
    token: ${TELEGRAM_BOT_TOKEN}
  discord:
    token: ${DISCORD_BOT_TOKEN}
  slack:
    token: ${SLACK_BOT_TOKEN}

toolsets:                    # 使用するツールセット制限または有効化
  - web
  - terminal
  - file
  - skills


セキュリティのため、API Key を設定ファイルに直接書き込むより、Terminal の環境変数機能を活用してください。export OPENROUTER_API_KEY="sk-or-xxxxx" コマンドを .bashrc や .zshrc に登録しておけば、設定ファイルが漏洩しても大切な API コストを守れます。特に外部サーバー(VPS)で運用するときは、Terminal オプションを dockerに設定して、エージェントが自分のシステム全体を操作しないように隔離することが必須です。


  • VS Code など GUI エディターを活用した安全な YAML 編集
  • 環境変数(export)を活用した API Key セキュリティ強化戦略
  • VPS 運用時、システム保護のための Docker 隔離環境設定
  • Telegram、Discord、Slack など複数ゲートウェイ連携オプション
  • Toolsets 設定によるエージェントの権限範囲管理
  • 設定変更後、エージェント再起動による実時間反映確認

Skill システム理解と知能型メンテナンス


Hermes Agent の最も強力な特徴は Skill システムです。Skill とは、エージェントが学んだ作業手順を保存した Markdown ファイルです。例えば、マークダウンを HTML に変換してほしいとリクエストすると、エージェントはその複雑なプロセスを ~/.hermes/skills/markdown-to-html.md のようなファイルに自動保存します。次回、同じリクエストをすると、このファイルを読んで、ずっと速く、正確に処理するようになるのです。


インストール後、長く使用していると SQLite ベースの state.db の容量が大きくなることがあります。時々 Terminal で du -h ~/.hermes/state.db コマンドで容量をチェックしてみてください。もしエージェントの記憶が混乱していると感じたら、memories フォルダ内の MEMORY.md を直接開いて、間違った情報を修正または削除できます。


# メモリ メンテナンス例
nano ~/.hermes/memories/MEMORY.md  # エージェントが記憶する私についての情報修正
rm ~/.hermes/skills/unwanted.md    # 誤って学んだスキル削除


最も一般的なエラーである YAML parsing error は、ほとんどの場合、インデント問題またはタブ文字が混在しているときに発生します。また、hermes コマンドが実行されない場合は、新しいターミナルウィンドウを開くか、pip install --upgrade hermes-agent でパッケージを最新化してみてください。時間とともに、自分をより理解し、必要なツールを自分で作り出すカスタマイズされた自分のエージェントを完成させる楽しさを、ぜひ感じてみてください。


  • Markdown ベース Skill システムの動作原理および活用
  • state.db 容量確認および定期的なデータベース管理
  • MEMORY.md 直接編集によるエージェントの記憶キュレーション
  • YAML Parsing Error および パス認識問題解決方法
  • 最新機能活用のための定期的なパッケージアップグレード
  • ユーザーカスタム技術(Skill)削除および再学習による最適化

それでは Terminal を開いて、自分のエージェントとの対話を始めてみてください。生産性の次元が変わる体験をすることになるでしょう。