DEV Community

Cover image for Hermes Agent の使い方
Akira
Akira

Posted on • Originally published at apidog.com

Hermes Agent の使い方

要約: Hermes Agentは、学習した内容を記憶し、時間とともに賢くなるオープンソースのAIアシスタントです。1つのコマンドでインストールし、LLMプロバイダーを設定するだけで、CLI、Telegram、Discord、またはIDEを介してチャットを開始できます。このガイドでは、Hermesのインストール、セットアップ、日常的な使用方法、高度な機能、そして最大限に活用する方法について説明します。

Apidogを今すぐ試してみよう

Hermes Agentとは？

Hermes Agentは、NousResearchによって構築されたパーソナルAIアシスタントで、24時間年中無休で稼働し、学習したすべてを記憶し、時間とともに能力が向上します。ChatGPTやClaudeが会話ごとにまっさらな状態から始まるのとは異なり、Hermesはあなたの仕事、プロジェクト、および好みの永続的なモデルを構築します。

主な機能:

  • 記憶する — 会話、決定、作成したコードを保存
  • 学習する — タスクから再利用可能なスキルを自動生成
  • マルチプラットフォーム — CLI、Telegram、Discord、Slack、WhatsApp、IDE対応
  • セルフホスト型 — ラップトップ/VPS/クラウド上で動作
  • モデル非依存 — 200以上のモデルを選択可
  • 拡張可能 — プラグインでカスタムツール/コマンド追加

Hermesはこんな方におすすめ:

  • 自分のコードベースに精通したAIペアプログラマーを求める開発者
  • マルチユーザーサポート付きAIアシスタントが必要なチーム
  • cronスケジューリングで24時間エージェント自動化したいパワーユーザー
  • 軌跡データを使いカスタムAIモデルをトレーニングしたい研究者

インストール：ステップバイステップ

前提条件

  • OS: macOS, Linux, Windows（WSL推奨）
  • Python: 3.10以上
  • Git: リポジトリのクローン用
  • APIキー: OpenRouter, Anthropic, OpenAIなど

クイックインストール（推奨）

最速インストール手順:

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

このスクリプトで自動的に以下を実行します:

  1. Hermesリポジトリをクローン
  2. uv（高速Pythonパッケージマネージャ）をインストール
  3. 仮想環境を作成
  4. 依存関係をインストール
  5. HermesをPATHに追加

インストール後、シェルをリロード:

source ~/.bashrc  # Bashの場合
source ~/.zshrc   # Zshの場合

インストール確認:

hermes --version

Hermes Agent v0.5.0のように表示されればOK。

手動インストール（開発者向け）

手動で細かく制御したい場合:

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

curl -LsSf https://astral.sh/uv/install.sh | sh

uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# または
.\venv\Scripts\activate  # Windows

uv pip install -e ".[all,dev]"

python -m pytest tests/ -q

RLトレーニングサポート付きでインストール

カスタムモデルを学習させたい場合:

git submodule update --init tinker-atropos
uv pip install -e "./tinker-atropos"

初期設定と構成

セットアップウィザードを実行する

初回ユーザーは対話的セットアップ:

hermes setup

ウィザード内容:

  1. LLMプロバイダー選択（OpenRouter, Anthropic, OpenAI等）
  2. APIキー設定（~/.hermes/.envに保存）
  3. 永続メモリ有効/無効
  4. ターミナルバックエンド（ローカル/Docker/SSHなど）
  5. ゲートウェイ設定（Telegram/Discord/Slack統合）

手動設定

設定ファイル編集やCLIで直接設定可能:

hermes config edit
hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend local
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

設定ファイルの場所

~/.hermes/
├── config.yaml      # 設定
├── .env             # APIキー
├── memory/          # 永続メモリ
├── skills/          # スキル
└── plugins/         # プラグイン

セットアップの確認

hermes doctor
  • 設定/キー/メモリ/ゲートウェイ/ターミナルの状態をチェック

LLMプロバイダーの選択

Hermesは200以上のモデルをサポート。主なセットアップ例:

OpenRouter（初心者推奨）

1キーで200＋モデル。無料枠あり。

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

人気モデル例:

モデル

ユースケース

コスト

anthropic/claude-opus-4

複雑なコーディング、推論

$$$

anthropic/claude-sonnet-4

バランスの取れたパフォーマンス

$$

openai/gpt-4o

汎用

$$

google/gemini-pro-1.5

長いコンテキストウィンドウ

$

meta/llama-3-70b

オープンソース、高速

$

Anthropic Direct

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4

OpenAI Direct

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...

ローカルモデル (Ollama)

# Ollamaインストール: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

モデル設定例

スマートルーティング:

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini

コスト管理:

model:
  budget:
    daily_limit: 5.00  # USD
    monthly_limit: 100.00

基本的な使用法：CLIモード

Hermesの起動

hermes

起動後、すぐにチャット可能。

基本コマンド例

> ねえ、JSONをパースするPython関数を書いて
> /help
> /skills
> /memory
> /config
> /clear
> /history
> ファイル ./src/main.py を見てリファクタリングして
> 実行: npm install && npm run build

コマンド実行前に確認が入ります。

永続シェル

> cd /my/project && source venv/bin/activate
> python src/main.py

仮想環境やディレクトリ状態が保持されます。

ファイル操作

> config.yaml の内容を見せて
> main.py でポート番号を5432→5433に変更して
> utils.pyという新しいファイルを作成して

多段階ワークフロー

> Flaskアプリに認証を追加して
> 1. モデル作成
> 2. エンドポイント作成
> 3. JWT生成
> 4. テスト作成

各工程ごとに確認・実行。

メッセージングゲートウェイ：Telegram、Discord、Slack

Telegramセットアップ

  1. @botfatherで/newbot→ボットトークン入手
  2. Hermesにトークンを設定
    hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF...
  3. ゲートウェイ起動
    hermes gateway setup telegram
hermes gateway start
  4. Telegramでチャット

Discordセットアップ

  1. Discordアプリ作成＆ボットトークン生成
  2. ボットをサーバー招待
  3. Hermesに設定
    hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start
  4. メンションまたはDMで利用

Slackセットアップ

  1. Slackアプリ作成＆Bot権限付与
  2. ワークスペースにインストール＆トークン取得
  3. Hermes設定
    hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

マルチプラットフォームでの使用

hermes gateway start --all

全プラットフォーム間で会話状態を自動同期。

IDE統合：VS Code、JetBrains

VS Code統合

  1. 拡張機能「Agent Communication Protocol」インストール
  2. Hermes ACPサーバー起動
    hermes acp start
  3. エディター内からチャット/コマンド利用

JetBrains統合

  1. 「ACP」プラグイン導入
  2. Hermes ACPサーバー起動
    hermes acp start
  3. AI Agents設定でHermesをバックエンドに指定

Zedエディター

{
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}
hermes acp start

メモリと学習システム

メモリの種類

> /memory search "データベース移行"
> /memory projects
> /skills list
  • エピソード記憶: 過去の会話・セッション
  • 意味記憶: プロジェクト・嗜好の知識グラフ
  • 手続き記憶: 再利用可能なスキル

セッション検索例

> /memory search "先週、JWTの有効期限切れはどう対処した？"

メモリナッジ

[Hermes]: 認証システムに取り組んでいることに気づきました。先週の火曜日に
JWTの有効期限切れに関する問題に言及していましたね。それについてもう一度確認しますか？

コンテキスト圧縮

  • 85%使用時にゲートウェイ圧縮
  • 50%でエージェント圧縮（設定可）

エクスポート・バックアップ

hermes memory export ~/backup/hermes-memory.json
hermes memory import ~/backup/hermes-memory.json

スキルとプラグイン

スキルとは？

Hermesが実行できる自動ワークフロー。組み込み例:

  • code_review — コードレビュー
  • debug_session — デバッグ
  • api_tester — APIテスト
  • git_workflow — Git操作
  • documentation — ドキュメント生成

スキルの操作例

> /skills list
> /skills install code_review
> /skills run code_review ./src/auth.py

カスタムスキル作成例

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "何か役に立つことをする"

    def execute(self, context):
        # スキルロジック
        return "スキルが正常に実行されました"

プラグインシステム

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "特定のタスク用のカスタムツール"

    def run(self, **kwargs):
        return {"result": "success"}
  • ツール — 新機能
  • コマンド — スラッシュコマンド追加
  • フック — ライフサイクルイベントハンドラ

高度な機能

Cronスケジューリング

> GitHub通知の毎日のダイジェストを午前9時に設定して
cron:
  - name: "日次ダイジェスト"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"

サブエージェント委任

> リポジトリ内の全PRをレビューして要約して

音声モード

hermes --voice
  • ボイスメッセージを送ると自動文字起こし・応答
  • Discord音声チャンネルにも参加可

ブラウザ制御

> github.comにアクセス、トレンドのPythonリポジトリを探して
hermes browser connect --cdp

MCP統合

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]

ワークツリーモード

hermes -w

Gitワークツリーごとに隔離して同時作業。

Hermes内で他のエージェントを実行

> このPRのレビューにclaude-codeを使って

トラブルシューティング

よくある問題

「APIキーが見つかりません」

hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...

「モデルが利用できません」

hermes models list
hermes config set model anthropic/claude-opus-4

「ゲートウェイの起動に失敗」

hermes gateway status
hermes gateway stop
hermes gateway start

「メモリの破損」

hermes memory export ~/backup/memory-backup.json
hermes memory reset
hermes memory import ~/backup/memory-backup.json

ヘルプを得る

/help
hermes logs tail --follow
hermes doctor

よくある質問

Hermesを実行する費用は？

  • Hermes自体は無料
  • LLMのAPI利用料のみ
  • OpenRouterなら月5〜15ドル程度 (軽度)
  • Ollama等ローカルモデルは無料

Hermesは24時間年中無休で稼働できますか？

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

Hermesはエンタープライズ用途に適していますか？

  • マルチユーザーセッション分離
  • PII編集によるコンプライアンス
  • サプライチェーンセキュリティ
  • セルフホストデプロイ
  • 監査ログ

OpenClawから移行するには？

hermes claw migrate --dry-run
hermes claw migrate
hermes doctor

Hermesはインターネットなしで使用可能？

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5-coder:32b
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

HermesとChatGPTの違いは？

機能

Hermes

ChatGPT

メモリ

永続的、検索可能

セッションのみ

デプロイ

セルフホスト、24時間年中無休

クラウドのみ

モデル選択

200以上のモデル

GPTのみ

拡張性

プラグイン、スキル

限定的

コスト

使用量のみ支払い

サブスクリプション

プライバシー

データを自分で制御

OpenAIがデータを保存

Hermesデータのバックアップ方法

hermes export --all ~/backup/hermes-full-backup.tar.gz

Hermesはローカルファイルにアクセス可能？

明示的に指定したファイルや許可ディレクトリのみアクセス可。デフォルト非許可。

💡AIを活用した開発ワークフローの一部としてAPIをテストしたいですか？APIの設計、テスト、ドキュメント作成のためのオールインワンAPI開発プラットフォームであるApidogをぜひお試しください。

Top comments (0)