メインコンテンツへ移動
AIチュートリアル

Hermes Agentで公式プラグインをインストールして使用する

Hermes Agentのインストール方法、審査済みプラグインカタログの確認方法、公式プラグインの追加・更新方法、旧インストールからの移行方法、プラグインをローカルでテストする方法を解説します。利用可能なファーストパーティ統合機能と、カタログピンによって管理されたリリースを実現する仕組みについても紹介します。

約16分で読了
Hermes Agentで公式プラグインをインストールして使用する
Hermes公式プラグイン

Hermes公式プラグインの提供内容

Hermes Official Pluginsは、Nous Researchが保守するHermes Agent向けの公式プラグインコレクションです。リポジトリ内の各ディレクトリには、Hermesプラグインカタログからインストールできる自己完結型の連携機能が含まれています。

Hermes Agentは、セッション間で有用な情報を保持し、経験からスキルを開発できる自己改善型AIエージェントです。ターミナル、Hermes Desktop、Telegram、Discord、Slack、WhatsApp、Signalなどのインターフェースから実行できます。Nous Portal、OpenRouter、Anthropic、OpenAI、カスタムエンドポイントなど、複数のモデルソースに対応しています。

このプロジェクトでは、エージェントループ、メモリ、スキル、ゲートウェイ、モデルルーティング、ツールランタイムなど、Hermesの汎用部分をコアに集約しています。製品固有およびベンダー固有の機能は、独立したプラグインとして提供されます。

Hermesがプラグインを採用する理由

  • インストールを小規模に: 必要な連携機能だけをインストールできます。
  • 独立した修正: プラグインは、Hermesコアの新しいリリースを待たずに、レビュー済みの更新を受け取れます。
  • 明確な所有権: 公式プラグインはNousが保守し、ベンダーや独立した作者はコミュニティプラグインを保守します。
  • レビュー済みバージョン: カタログのエントリはレビュー済みコミットに固定されるため、インストールと更新には既知のリビジョンが使用されます。
  • 効率的なダウンロード: Hermesはblobless sparse cloneを使用し、選択したプラグインのディレクトリだけを取得します。

前提条件とHermesのインストール

これらのプラグインを追加する前に、Hermes Agentが正常にインストールされている必要があります。サポート対象のシステムで、Hermes READMEに記載されたインストールスクリプトを実行します。

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

インストール後、コマンドラインインターフェースが利用できることを確認します。

hermes --help

プラグインによっては追加要件があります。たとえば、Spotifyではログイン用に独自のSpotify開発者アプリケーションが必要です。BlenderではMCPアドオンを備えたBlender 5.1以降が必要で、SnykではNode.js、npm、Snykアカウントが必要です。インストール前に、プラグインのカタログ情報を確認してください。

プラグインカタログを確認する

Hermesプラグインカタログには、レビュー済みの公式およびコミュニティ連携機能が掲載されています。検索コマンドで利用可能なエントリを確認できます。

hermes plugins search

インストール前に、特定のプラグインを確認します。

hermes plugins info spotify

情報エントリには、プラグインの機能、要件、固定先のレビュー済みコミットが記載されています。Hermes Desktopでは、Capabilities → Pluginsから同じカタログにアクセスできます。

プラグインのインストールと更新

  1. 必要な連携機能を検索します。

    hermes plugins search

  2. 要件とメタデータを確認します。

    hermes plugins info spotify

  3. レビュー済みバージョンをインストールします。

    hermes plugins install spotify

  4. 新しいレビュー済み固定先が利用可能になったら、プラグインを更新します。

    hermes plugins update spotify

更新では、カタログに記載された次のレビュー済みコミットが使用されます。任意のリポジトリリビジョンが自動的にインストールされることはありません。

公式プラグインを選ぶ

Home Assistant

Home Assistantプラグインは、エンティティの一覧表示、状態の読み取り、サービスの一覧表示、サービスの呼び出しを行うゲートウェイプラットフォームと4つのツールを追加します。Hermesはイベントバスを監視し、選択した状態変更に反応し、REST APIでデバイスを制御し、Home Assistantの通知を通じて応答できます。

hermes plugins install homeassistant

ツールはha_list_entities、ha_get_state、ha_list_services、ha_call_serviceです。Cronジョブではdeliver=homeassistantを指定してHome Assistantを対象にできます。

Spotify

Spotifyプラグインは、再生、Spotify Connectデバイス、キュー、検索、プレイリスト、アルバム、ユーザーのライブラリを操作するツールを提供します。

hermes plugins install spotify
hermes spotify login

ログインコマンドは、独自のSpotify開発者アプリケーションを使用して、ループバックPKCEログインを実行します。再生制御にはSpotify Premiumが必要です。

Claude Subscription DirectSDK

この実験的なモデルプロバイダーは、Claude ProまたはMaxサブスクリプションを使用し、公式Claude Code CLI経由でHermesの処理を実行します。Hermesは独自のエージェントループ、ツール、承認処理、コンパクションを維持し、プラグインは認証済みのclaudeバイナリをリクエスト単位のモデルクライアントとして使用します。

hermes plugins install claude-subscription-directsdk

インストール後、hermes modelを開き、Claude Subscription DirectSDK (Experimental)を選択します。Claude Codeを利用できない場合、プラグインは実行を拒否し、インストール方法のヒントを表示します。

Telegram Businessモード

Telegram Businessモードにより、HermesはTelegram Businessアカウント向けの承認付き監視アシスタントになります。顧客への返信案を作成できますが、送信前に毎回オーナーの承認が必要です。

hermes plugins install hermes-telegram-business

Memory Wiki

Memory Wikiは、ローカルのセッション履歴をトピックページと日次ログに整理するダッシュボードとHermes Desktopタブを追加します。また、MEMORY.mdとUSER.md用の読み取り専用監査パネルも提供します。このプラグインはローカル履歴を読み取りますが、書き込みは行いません。

hermes plugins install hermes-memory-wiki

Blender

Blenderプラグインは、公式Blender Lab MCPサーバーとBlenderワークフロースキルを組み合わせたものです。MCPアドオン付きのBlender 5.1以降に加え、Gitとuvが必要です。Windows、macOS、Linuxに対応しています。

hermes plugins install blender

BlenderツールはBlender内でPythonを実行します。信頼できるワークフローのみを使用し、シーンを変更する可能性のある操作を確認してください。

Snyk

SnykプラグインはSnykのファーストパーティMCPサーバーを使用し、snyk-security-scanワークフロースキルを含みます。ソースコード、依存関係、コンテナイメージ、Infrastructure as Code設定、ソフトウェア部品表をスキャンできます。

hermes plugins install snyk

Node.js、npm、Snykアカウントが必要です。認証はブラウザーを通じてsnyk_authで行います。

TouchDesigner

TouchDesignerプラグインは、TouchDesigner内で動作する404.zeroの無料twozero MCPサーバーを介して、稼働中のTouchDesignerセッションに接続します。ワークフロースキルと、オペレーター、GLSL、オーディオリアクティブプロジェクト、インスタンシングなどを扱う20以上のリファレンスファイルが含まれています。

hermes plugins install touchdesigner

TouchDesignerはmacOSとWindowsに対応しています。

Accent Picker

Accent Pickerは、ステータスバーにOKLCHカラーホイールを追加するHermes Desktopプラグインです。ピッカーをドラッグするとテーマの色合いがリアルタイムで変わるため、テーマ作成者はその場でアクセントカラーをテストできます。選択した色は一時的なスクラッチ状態であり、永続化されません。

hermes plugins install accent-picker

古いインストールを移行する

以前はHermesコアまたは別のリポジトリに含まれていた公式プラグインがいくつかあります。必要な移行手順は、最初にどの方法でインストールしたかによって異なります。

  • 組み込みのHome AssistantまたはSpotify: hermes updateを実行します。更新後の初回起動時に、既存の設定、環境変数、ログイン情報を維持したままカタログプラグインをインストールできます。
  • カタログからのインストール: hermes plugins update <name>を実行します。カタログは現在、公式プラグインリポジトリを参照しており、移行中もファイルを保持します。
  • URLベースのインストール: hermes plugins install <name> --forceを使用して、カタログから一度再インストールします。以前の単独リポジトリはアーカイブされ、修正を受け取らなくなったため、この手順が必要です。

リポジトリ構成を理解する

最上位にある各プラグインディレクトリは、完全なパッケージです。Pythonプラグインには通常、マニフェスト、登録コード、依存関係、テストが含まれます。移植可能なMCPベースのプラグインではplugin.json、mcp.json、スキルディレクトリを使用でき、Desktopプラグインにはdesktopディレクトリ内のJavaScriptを含めることができます。

hermes-official-plugins/
├── assets/
├── homeassistant/
│   ├── plugin.yaml
│   ├── __init__.py
│   ├── pyproject.toml
│   └── tests/
├── blender/
├── accent-picker/
└── ...

カタログは、リポジトリ、サブディレクトリ、固定コミットによってプラグインを識別します。そのため、SpotifyをインストールしてもHome Assistantプラグインはダウンロードされません。

プラグインをローカルでテストする

開発時は、Hermes Agentと公式プラグインリポジトリを同じ場所に並べてクローンします。

git clone https://github.com/NousResearch/hermes-agent
git clone https://github.com/NousResearch/hermes-official-plugins
cd hermes-official-plugins/spotify
HERMES_AGENT_REPO=../../hermes-agent PYTHONPATH=../../hermes-agent python -m pytest -q

公式プラグインは、プッシュとプルリクエストのたびに、Linux、macOS、Windows上の現行Hermesコアに対してテストされます。コアの変更によってプラグインが壊れることを検出するため、夜間テストも実施されます。

ローカルチェックアウトを実行中のHermes環境にインストールするには、ディレクトリパスを指定して強制置換します。

hermes plugins install ./spotify --force

高度なヒント

  • インストール前に確認する: hermes plugins info <name> を使用して、依存関係とレビュー済みコミットを確認します。
  • カタログ名を優先する: カタログからのインストールは、直接URLを指定するインストールよりも、今後レビュー済みのピンへ移行しやすくなります。
  • forceの使用には注意する: --force オプションは移行やローカルテストに便利ですが、意図したインストールを置き換えていることを確認してください。
  • 承認の境界を尊重する: Telegram Business Modeなどのプラグインでは、返信を送信する前に意図的に承認が必要です。
  • 強力な統合機能を確認する: Blenderなど、アプリケーション内でコードを実行するツールは、信頼できるワークフローでのみ使用してください。
  • 適切なリポジトリで問題を報告する: プラグイン固有の問題は公式プラグインリポジトリで報告し、タイトルにプラグイン名を含めてください（例: [spotify] ...）。コアの問題はHermes AgentのIssueトラッカーで報告します。

プラグインのリリースとビルド

メンテナーの場合、リポジトリのmainブランチにプラグインの変更をマージしただけでは、カタログ利用者は更新されません。Hermes Agentに対してプルリクエストを作成し、plugin-catalog/<name>.yaml内のプラグインのsha:値を変更することで、リリースが完了します。カタログのピンがリリースバージョンとして機能します。

独自の統合機能を作成するには、まずHermesプラグインガイドとサンプルプラグインを参照してください。標準プラグインは、plugin.yamlマニフェストを含む通常のPythonパッケージです。完成したプラグインは、レビューのためにHermesカタログへ提出できます。

まとめ

Hermes Official Pluginsは、すべての統合機能をコアに組み込むことなく、Hermes Agentを拡張するための管理された方法を提供します。カタログを検索し、プラグインの要件を確認し、レビュー済みのピンをインストールして、更新コマンドで後続のレビュー済みリビジョンへ移行します。開発者はリポジトリをクローンし、プラグイン固有のテストを実行し、実環境でのテスト用にローカルディレクトリをインストールすることもできます。