Skip to main content
Hermes AgentはNous ResearchによるオープンソースのターミナルAIエージェントで、強力なツール呼び出し、ファイルの読み書き、コード実行の機能をターミナルで利用できます。Custom Endpointのサポートを内蔵しているため、コードやプラグインを作成することなく、Mixrouteを含むあらゆるOpenAI互換APIにシームレスに接続できます。

​
主な機能

インテリジェントエージェント

永続メモリを備え、ツール呼び出し、ファイルの読み書き、コード実行にネイティブ対応

マルチチャネル連携

Telegram、Discord、Slack、WhatsAppなどに対応した統合メッセージングゲートウェイ

オープンなモデルエコシステム

あらゆるOpenAI互換APIに対応するCustom Endpoint機能を内蔵

​
前提条件

1

Mixrouteのアドレスを用意

利用可能なMixrouteのアドレスを取得します。例：https://api.mixroute.ai/v1
ネイティブAPIを使用する必要がある場合は、APIドキュメントのエンドポイントに従って設定する必要があります。エンドポイントの違いによるエラーや問題を避けるため、このガイドの設定を維持することをおすすめします。
2

APIキーの取得

MixrouteコンソールでAPIキーを生成してください
3

モデルの選択

使用するモデル名を決めてください。MixrouteコンソールのモデルID（例: gpt-5.5）と完全に一致する必要があります
Hermes Agentには、少なくとも64Kトークンのコンテキストウィンドウをサポートするモデルが必要です。モデルを選択する際にこの要件を確認してください。満たしていない場合、コンテキスト不足のエラーが発生する可能性があります。

​
Hermes Agentをインストールする

  • ターミナルで公式のワンクリックインストールスクリプトを実行してください。Quick setupモードを選択してデプロイし、基本設定を行います。ProviderとModelの詳細については、mixroute連携の設定を参照してください。
  • インストール後、ターミナルの環境変数を再読み込みします。
hermes --versionを実行してください。バージョン番号が表示されれば、インストールは成功です。

​
Mixroute連携を設定

これは連携手順の中で最も重要なステップです。Hermes Agentには対話型メニューが用意されているため、コードの記述や設定ファイルの手動編集は不要です。表示される案内に従って、MixrouteのURL、キー、モデル名を入力するだけです。
設定後に設定内容を変更したい場合や、対話型ガイドでプロバイダーの設定を完了できなかった場合は、Hermes Agentのデプロイ後、いつでもhermes modelを実行して以前の設定を上書きし、新しいURL、キー、モデル名を入力できます。
1

プロバイダーを選択

矢印キーでCustom Endpoint（または同様の「カスタムエンドポイント」項目）まで移動し、Enterを押して確定します。
複数のプロバイダーを利用する場合は、個別に管理できるよう、プラットフォーム上で複数のSKを設定することを推奨します。
2

ベースURLを入力

Mixrouteのアドレスを入力します。例:
これは設定エラーの最も一般的な原因です。モデルのネイティブ機能を使用する必要があります。APIドキュメントとモデルマーケットプレイスの情報を参照して、Base URLを修正してください。エンドポイントが一致していないと、Hermesが正常に動作しなかったり、追加料金が発生したりする場合があります。
3

APIキーの入力

Mixrouteコンソールで生成したAPIキーを入力します。例:
4

モデル名を入力

使用するモデルを入力してください。例:
モデル名は、MixrouteのモデルカタログにあるIDと完全に一致している必要があります。一致しない場合は「model not found」エラーが発生します。
5

APIモードを選択する

Hermesには4つの互換モードがあります。モデルに合わせて選択してください。HermesのデフォルトはAuto-detectです。
  1. Auto-detect [current]
    HermesのURLヒューリスティックを使用します。標準的なOpenAI互換エンドポイントに最適です。
  2. Chat Completions
    標準的なOpenAI互換サーバーには/chat/completionsを使用してください。
  3. Responses / Codex
    Codex互換のツール呼び出しバックエンドには/responsesを使用してください。
  4. Anthropic Messages
    Anthropic互換エンドポイントには/v1/messagesを使用してください。

​
スマートルーティングの連携（任意）

スマートルーティングは、タスクの複雑さに基づいてリクエストを最適なモデルに自動的に振り分け、効率を高めながらAPIコストを削減するインテリジェントなモデルルーティング機能です。以下の設定を追加して連携を完了します。制約と利用ガイドについては、こちらを参照してください。

​
主要な設定のリファレンス

​
連携の確認

設定後、Hermesを起動して会話を開始します。
または、よりモダンなTUIモード（ターミナルのグラフィカルインターフェース）を使用します。
テストメッセージを入力します。例：
モデルが正常に応答すれば、連携は成功しています。

​
モデルの確認と切り替え

現在のモデルを確認してすばやく切り替えるには、会話内で次のコマンドを直接入力してください。

​
FAQ

ベースURLの末尾が/v1になっているか確認してください
モデル名がMixrouteコンソールのモデルIDと完全に一致していることを確認します
Mixrouteコンソールで新しいキーを生成し、hermes modelを再実行してください
ターミナルでhermes modelと入力し、Enterを押します
hermes modelを再度実行するか、会話内で/modelを入力してください
hermes modelを再度実行すると、以前の設定が上書きされます。
HermesはWindowsにネイティブ対応していません。先にWSL2をインストールし、WSL2のターミナルでインストールコマンドを実行してください
Mixrouteとの連携後は、Hermes Agentの以降のすべての機能（メッセージングゲートウェイ、スキル呼び出し、バックグラウンドサービスなど）が、Mixroute経由で選択したモデルを呼び出します。機能ごとにモデルプロバイダーを個別に設定する必要はありません。