Hermes Agent 無料インストール＆使い方ガイド：自分だけの自律進化AIエージェントを構築しよう

Hermes Agentが気になり始めたのは数週間前。GitHubリポジトリ（37.5kスター、MITライセンス、Nous Research製）をざっと見てみて、ほとんどのAIエージェントにはない機能があることに気づいた。使えば使うほど賢くなるんだ。よくある「モデルが改善される」みたいな曖昧な話じゃなくて、ユーザーとのやり取りからスキルを構築し、うまくいった方法を記憶して、そのスキルを継続的に磨いていく。それだけでも試す価値がある。

決め手になったのはこれ：$5のVPSで動く。GPUは不要（もちろんあってもいい）。Telegram、Discord、Slack、WhatsAppなど十数のプラットフォームに接続できる。VPSプロバイダーとしてはLightNodeをおすすめ——時間課金で$0.013/時間から使えて、自前AIを試すにはコスパ最強。

目次

1. Hermes Agentは何ができるのか
2. システム要件
3. インストール
4. 無料モデルプロバイダーの設定
5. 設定
6. 初めてのセッション
7. メッセージングプラットフォームへの接続
8. 知っておくべき主要機能
9. トラブルシューティング
10. まとめ

Hermes Agentは何ができるのか

ほとんどのAIエージェントは同じパターン：プロンプトを送るとツールを実行し、結果を返し、全部忘れる。Hermes Agentは別のアプローチをとる。学習ループが組み込まれている：

1. タスクを与える
2. 必要なスキルを分析する
3. スキルが存在しない場合は新しく作成する
4. スキルを使ってタスクを実行し、結果を評価し、うまくいった方法を保存する
5. 次に似たタスクを頼むと、磨き上げられたスキルを呼び出す

つまり、このエージェントは実際に使うほど成長する。ベースモデルのアップデートを待つ必要がない。あなたのワークフロー、あなたのコードベース、あなたの操作パターン——そういうのを学習してくれる。

学習ループ以外にも、Hermes Agentは47個の組み込みツールを持ち、MCP（Model Context Protocol）統合で機能を拡張でき、サブエージェントにタスクを委譲できる。定期実行スケジューラーとボイスモードもある。

システム要件

インストール前に、以下の条件を満たしているか確認：

• OS：Linux（Ubuntu 20.04+推奨）、macOS（12+）、またはWSL2経由のWindows
• Python：3.10以上
• メモリ：最低2GB、推奨4GB
• ディスク：エージェント自体で約500MB
• ネットワーク：モデルAPI呼び出し用のインターネット接続

AndroidユーザーはTermuxでもOK。Windowsネイティブは非対応——WSL2が必要。

VPSにデプロイする場合、$5/月で1 vCPU + 1GB RAMのマシンで軽い使い方なら十分。負荷が高い場合（複数のメッセージングプラットフォーム、頻繁な定期実行）は2GB以上を推奨。

インストール

Hermes Agentのインストール方法は2つ。クイックインストールは全部自動でやってくれる。手動インストールはより細かい制御ができる。

方法1：ワンライナーインストール（推奨）

ターミナルを開いて実行：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

このスクリプトが全部やってくれる：依存関係のチェック、仮想環境の作成、リポジトリのクローン、パッケージのインストール、初期セットアップウィザードの実行。まっさらなUbuntuマシンなら、全部で2〜3分。

完了したら、インストールを確認：

hermes --version

バージョン番号が表示されるはず。"command not found"エラーが出る場合は、シェルを再起動するかsource ~/.bashrc（zshの場合は~/.zshrc）を実行。

方法2：手動インストール

マシンに何がインストールされるか把握したい場合や、ワンライナーがうまくいかない場合：

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

# 仮想環境を作成して有効化
python3 -m venv venv
source venv/bin/activate

# 依存パッケージをインストール
pip install -r requirements.txt

# セットアップウィザードを実行
python setup.py

セットアップウィザードがモデルプロバイダーの選択、APIキーの入力、基本設定を案内してくれる。後からhermes setupでいつでも再実行可能。

無料モデルプロバイダーの設定

Hermes Agentにはモデルが内蔵されていない。外部プロバイダーに接続する。良いニュース：いくつかのプロバイダーは無料枠を提供していて、そのまま使える。

オプション1：OpenRouter（一番簡単な無料オプション）

OpenRouterは200以上のモデルにアクセスでき、そのうちいくつかは無料。最初の選択肢としておすすめ。

1. openrouter.aiでアカウント作成
2. ダッシュボードからAPIキーを生成
3. 無料モデルを見つける——モデルカタログで"free"タグを探す

OpenRouterでよく使える無料モデルにはLlama、Mistral、Qwenの各バリエーションがある。無料モデルは入れ替わるので、現在のカタログをチェックしよう。

Hermes Agentのセットアップウィザードで"OpenRouter"をプロバイダーとして選択し、APIキーを貼り付けるだけ。

オプション2：Nous Portal

Nous Researchが独自の推論ポータルを運営している。新規ユーザーに無料クレジットが提供されることがあり、そこのモデルはエージェントワークロード向けにチューニングされている。

1. nousresearch.comにアクセスして登録
2. ダッシュボードで無料クレジットの有無を確認
3. 提供されたAPIキーをHermes Agentに設定

オプション3：その他のプロバイダー

Hermes Agentは以下もサポート：

• z.ai / GLM：中国のAIプラットフォーム、無料枠あり
• Kimi / Moonshot：無料利用枠付きのもう一つの選択肢
• MiniMax：軽い使い方なら無料枠あり
• OpenAI互換エンドポイント全般：他のプロバイダーにアクセスできるなら、それも接続可能

カスタムエンドポイントの設定にはベースURLとAPIキーが必要。セットアップウィザードで対応できるし、設定ファイルを直接編集してもいい（次のセクションで説明）。

設定

Hermes Agentの設定ファイルは~/.hermes/config.toml。セットアップウィザードを実行すると、こんな感じになる：

[model]
provider = "openrouter"
api_key = "sk-or-v1-..."
model = "meta-llama/llama-3.3-70b-instruct:free"

[agent]
name = "Hermes"
memory = true
skills_dir = "~/.hermes/skills"

[messaging]
# メッセージングプラットフォームの設定はここに
# telegram_token = ""
# discord_token = ""

主要な設定項目

モデル設定：いつでもモデルやプロバイダーを切り替えられる。OpenRouterの別の無料モデルを試したければ、modelフィールドを更新するだけ。プロバイダー全体を変更するなら、providerを"openai"や"nous"に変更してAPIキーを更新。

メモリ：memory = trueのままにしておこう。これが学習ループを有効にする。エージェントは会話履歴とスキルの改良記録を~/.hermes/memory/に保存する。

スキルディレクトリ：学習したスキルがここに保存される。~/.hermes/skills/を覗いてみると、エージェントが何を身につけたか確認できる。スキルはJSONファイルで保存されていて、手動で微調整も可能。

CLIからモデルを切り替え

設定ファイルを毎回編集する必要はない。Hermes Agentには組み込みコマンドがある：

# 現在のプロバイダーで利用可能なモデルを一覧
hermes model list

# 特定のモデルに切り替え
hermes model set meta-llama/llama-3.3-70b-instruct:free

# 現在使用中のモデルを確認
hermes model show

ヘルスチェック

設定変更後にこれを実行して、すべて正しく接続されているか確認：

hermes doctor

APIキー、モデルの可用性、ネットワーク接続、スキルシステムの状態をチェックしてくれる。何か問題があれば、どう直せばいいか教えてくれる。

初めてのセッション

設定が済んだら、セッションを開始：

hermes chat

インタラクティブなREPLが開く。まずはシンプルなものを試そう：

You: What tools do you have available?
Hermes: I have access to 47 built-in tools including:
- file_read / file_write (file operations)
- shell_exec (run shell commands)
- web_search / web_fetch (web access)
- code_search (search codebases)
- calendar / reminders (scheduling)
- ...and more. I can also use MCP tools if configured.

次に、本当のタスクを頼んでみる：

You: Create a Python script that monitors a directory for new files and logs their names to a file called new_files.log

Hermes: I'll create that for you.
[creates watch_dir.py with inotify or polling-based implementation]
[tests the script]
The script is ready at ./watch_dir.py. Run it with python watch_dir.py /path/to/watch

最初の依頼では、エージェントがゼロからスキルを構築する。後で似たタスクを頼むと、磨き上げられたバージョンを再利用する。何回かセッションを重ねてからスキルディレクトリを見てみると、その効果がわかる。

メッセージングプラットフォームへの接続

Hermes Agentの際立つ機能の一つがプラットフォーム対応。CLIだけでなく、15以上のメッセージングプラットフォーム経由で会話できる。

Telegramの設定

1. Telegramで@BotFatherにメッセージして新しいボットを作成
2. ボットトークンをコピー
3. 設定に追加：

hermes gateway add telegram --token "YOUR_BOT_TOKEN"

4. ゲートウェイを起動：

hermes gateway start telegram

これでTelegramから直接エージェントとチャットできる。CLIセッションと同じメモリとスキルが共有される。

Discordの設定

1. Discord Developer Portalでボットを作成
2. Message Content Intentを有効化
3. ボットトークンをコピー
4. 設定：

hermes gateway add discord --token "YOUR_BOT_TOKEN"
hermes gateway start discord

その他の対応プラットフォーム

どのプラットフォームでも手順は同じ。hermes gateway add <platform>に必要な認証情報を付けて実行：

• Slack：ボットスコープを持つSlack Appが必要
• WhatsApp：WhatsApp Business APIまたは非公式ブリッジを使用
• Signal：signal-cliのセットアップが必要
• Matrix：Matrixボットアカウントが必要
• Mattermost：個人アクセストークン
• Email：IMAP/SMTP認証情報
• SMS：Twilioや類似サービス
• DingTalk / Feishu / WeCom：中国系メッセージングプラットフォーム

hermes gateway listを実行すると、利用可能なすべてのプラットフォームとその状態を確認できる。

知っておくべき主要機能

スキルハブ

Hermes Agentにはコミュニティスキルリポジトリがある。他の人が作ったスキルを閲覧・インストールできる：

# コミュニティスキルを閲覧
hermes skills browse

# 特定のスキルをインストール
hermes skills install web-scraper

# インストール済みスキルを一覧
hermes skills list

エージェントがゼロから学習するのを待ちたくない場合に便利。Webスクレイピング、APIテスト、ドキュメント解析のような一般的なタスクなら、もう誰かがスキルを作っているはず。

定期実行

外部cronなしで定期タスクを設定：

hermes cron add "0 9 * * *" "Summarize yesterday's git commits and post to #dev-channel"

エージェントが内部的にスケジューリングを処理し、スキルを使ってタスクを実行する。

ボイスモード

手を離して使いたい場合：

hermes chat --voice

システムのマイクとスピーカーを使用する。音声入力に対応したモデルとの相性が良いが、ローカルの音声認識レイヤーを使うこともできる。

サブエージェント委譲

複雑なマルチステップタスクでは、Hermes Agentがサブエージェントを起動できる：

You: Research the top 5 VPS providers, compare their pricing, and create a summary document

Hermes: I'll delegate this to subagents for parallel research.
[spawns subagents for each provider]
[collects results]
[generates comparison document]

サブエージェントは親エージェントのメモリとスキルシステムを共有するため、メインエージェントが蓄積した経験をすべて活用できる。

トラブルシューティング

"command not found: hermes"

インストールスクリプトはHermesをPATHに追加するが、現在のシェルに反映されていない可能性がある。対処法：

source ~/.bashrc  # または ~/.zshrc

それでもダメな場合は、~/.local/bin/hermesが存在するか確認して、手動でPATHに追加：

export PATH="$HOME/.local/bin:$PATH"

APIキーエラー

まずhermes doctorを実行。APIキーが無効か期限切れか、選択したモデルが利用不可か教えてくれる。よくある対処法：

• OpenRouter：openrouter.ai/keysでキーを確認
• 無料モデルにはレート制限がある場合がある——別の無料モデルを試す
• APIキーの末尾に余分なスペースがないか確認

モデルが応答しない

無料枠のモデルには使用量上限がある。上限に達したら：

hermes model list    # 利用可能なモデルを確認
hermes model set <different-free-model>  # 切り替え

メモリ使用量が多い

エージェントのメモリが大きくなりすぎた場合（du -sh ~/.hermes/memory/で確認）、古いエントリを整理できる：

hermes memory prune --older-than 30d

最近のやり取りとスキルは保持しつつ、30日以上前の会話ログを削除する。

ゲートウェイ接続の問題

メッセージングプラットフォームの場合、まずゲートウェイプロセスが動いているか確認：

hermes gateway status

ゲートウェイが頻繁に切断される場合は、ネットワークを確認してから再起動：

hermes gateway restart telegram

まとめ

Hermes Agentは、他のオープンソースエージェントがうまくやれていないことを実現している：実際に使うほど学習し、成長する。ワークフローを手動で定義したり、カスタムプラグインを書いたりする必要がない。スキルシステムこそが本当の差別化ポイント——最初は10分かかるタスクが、5回目には30秒で終わるようになる。

安いハードウェアで動いて、無料のモデルプロバイダーに接続できる。つまり、ほぼゼロコストで24時間365日稼働する個人AIエージェントを持てる。TelegramやDiscordに接続すれば、自分の好みもコードベースもワークフローも覚えてくれる、いつでも使えるアシスタントの完成だ。

始め方：

1. VPSを用意する（ローカルマシンでもOK）——LightNodeが使いやすい
2. ワンライナーインストーラーを実行
3. OpenRouterに登録して無料モデルを取得
4. チャット開始

GitHubリポジトリに詳しいドキュメントがあり、コミュニティも活発。週末に試してみよう——月曜には、あなたの仕事に特化したスキルを蓄積し始めたエージェントができているはずだ。