> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes

> Hermes Agentをインストール・設定し、Custom Endpoint経由でMixroute APIに接続する方法

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

* 公式サイト: [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com)
* すぐに始める：[クイックスタート](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart)
* GitHub：[NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)

## 主な機能

<CardGroup cols={3}>
  <Card title="インテリジェントエージェント" icon="robot">
    永続メモリを備え、ツール呼び出し、ファイルの読み書き、コード実行にネイティブ対応
  </Card>

  <Card title="マルチチャネル連携" icon="message">
    Telegram、Discord、Slack、WhatsAppなどに対応した統合メッセージングゲートウェイ
  </Card>

  <Card title="オープンなモデルエコシステム" icon="plug">
    あらゆるOpenAI互換APIに対応するCustom Endpoint機能を内蔵
  </Card>
</CardGroup>

## 前提条件

<Steps>
  <Step title="Mixrouteのアドレスを用意">
    利用可能なMixrouteのアドレスを取得します。例：`https://api.mixroute.ai/v1`

    <Note>
      ネイティブAPIを使用する必要がある場合は、APIドキュメントのエンドポイントに従って設定する必要があります。エンドポイントの違いによるエラーや問題を避けるため、このガイドの設定を維持することをおすすめします。
    </Note>
  </Step>

  <Step title="APIキーの取得">
    MixrouteコンソールでAPIキーを生成してください
  </Step>

  <Step title="モデルの選択">
    使用するモデル名を決めてください。MixrouteコンソールのモデルID（例: `gpt-5.5`）と完全に一致する必要があります
  </Step>
</Steps>

<Info>
  Hermes Agentには、少なくとも64Kトークンのコンテキストウィンドウをサポートするモデルが必要です。モデルを選択する際にこの要件を確認してください。満たしていない場合、コンテキスト不足のエラーが発生する可能性があります。
</Info>

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

<Tabs>
  <Tab title="Linux / macOS / WSL2">
    * ターミナルで公式のワンクリックインストールスクリプトを実行してください。`Quick setup`モードを選択してデプロイし、基本設定を行います。ProviderとModelの詳細については、**mixroute連携の設定**を参照してください。

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    * インストール後、ターミナルの環境変数を再読み込みします。

    ```bash theme={null}
    source ~/.bashrc	# If using zsh, use source ~/.zshrc
    ```
  </Tab>

  <Tab title="Windows">
    <Warning>
      Hermes AgentはWindowsをネイティブにサポートしていません。まずWSL2（Windows Subsystem for Linux 2）をインストールし、その後WSL2のターミナルで上記のLinux/macOS用インストールコマンドを実行する必要があります。
    </Warning>

    WSL2のインストール参考資料: [Microsoft WSLインストールガイド](https://learn.microsoft.com/windows/wsl/install)
  </Tab>
</Tabs>

<Check>
  `hermes --version`を実行してください。バージョン番号が表示されれば、インストールは成功です。
</Check>

## Mixroute連携を設定

これは連携手順の中で最も重要なステップです。Hermes Agentには対話型メニューが用意されているため、コードの記述や設定ファイルの手動編集は不要です。表示される案内に従って、MixrouteのURL、キー、モデル名を入力するだけです。

<Note>
  設定後に設定内容を変更したい場合や、対話型ガイドでプロバイダーの設定を完了できなかった場合は、Hermes Agentのデプロイ後、いつでも`hermes model`を実行して以前の設定を上書きし、新しいURL、キー、モデル名を入力できます。
</Note>

<Steps>
  <Step title="プロバイダーを選択">
    矢印キーで**Custom Endpoint**（または同様の「カスタムエンドポイント」項目）まで移動し、Enterを押して確定します。

    <Tip>
      複数のプロバイダーを利用する場合は、個別に管理できるよう、プラットフォーム上で複数のSKを設定することを推奨します。
    </Tip>
  </Step>

  <Step title="ベースURLを入力">
    Mixrouteのアドレスを入力します。例:

    ```text theme={null}
    https://api.mixroute.ai/v1
    ```

    <Warning>
      これは設定エラーの最も一般的な原因です。モデルのネイティブ機能を使用する必要があります。APIドキュメントとモデルマーケットプレイスの情報を参照して、Base URLを修正してください。

      エンドポイントが一致していないと、Hermesが正常に動作しなかったり、追加料金が発生したりする場合があります。
    </Warning>
  </Step>

  <Step title="APIキーの入力">
    Mixrouteコンソールで生成したAPIキーを入力します。例:

    ```text theme={null}
    sk-xxxxxxxxxxxxxxxx
    ```
  </Step>

  <Step title="モデル名を入力">
    使用するモデルを入力してください。例:

    ```text theme={null}
    gpt-5.5
    ```

    <Warning>
      モデル名は、MixrouteのモデルカタログにあるIDと**完全に一致**している必要があります。一致しない場合は「model not found」エラーが発生します。
    </Warning>
  </Step>

  <Step title="APIモードを選択する">
    Hermesには4つの互換モードがあります。モデルに合わせて選択してください。HermesのデフォルトはAuto-detectです。

    1. `Auto-detect [current]`<br />HermesのURLヒューリスティックを使用します。標準的なOpenAI互換エンドポイントに最適です。
    2. `Chat Completions`<br />標準的なOpenAI互換サーバーには`/chat/completions`を使用してください。
    3. `Responses / Codex`<br />Codex互換のツール呼び出しバックエンドには`/responses`を使用してください。
    4. `Anthropic Messages`<br />Anthropic互換エンドポイントには`/v1/messages`を使用してください。
  </Step>
</Steps>

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

<Tip>
  [スマートルーティング](https://console.mixroute.ai/smart-route)は、タスクの複雑さに基づいてリクエストを最適なモデルに自動的に振り分け、効率を高めながらAPIコストを削減するインテリジェントなモデルルーティング機能です。

  以下の設定を追加して連携を完了します。制約と利用ガイドについては、[こちら](/ja/api-reference/smart-routing)を参照してください。

  ```text theme={null}
  # Smart Routing
  API Key : <you smart routing key>
  API Host : https://api.mixroute.ai/v1
  Models: auto
  ```
</Tip>

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

<Tabs>
  <Tab title="従来のAPIノード">
    | 設定項目 | 説明 | 例 |
    | - | - | - |
    | ベースURL | Mixrouteのアドレス。末尾は`/v1`である必要があります | `https://api.mixroute.ai/v1` |
    | APIキー | Mixrouteコンソールで生成したトークン | `sk-xxxxxxxxxxxxxxxx` |
    | モデル | モデル名。Mixrouteが公開するモデルIDと一致する必要があります。 | `gpt-5.5` |
  </Tab>

  <Tab title="スマートルーティングノード">
    | 設定項目 | 説明 | 例 |
    | :- | :- | :- |
    | ベースURL | Mixrouteのスマートルーティングのアドレス。末尾は`/v1`である必要があります | `https://api.mixroute.ai/v1` |
    | APIキー | Mixrouteのスマートルーティングコンソールで生成したトークン | `sk-xxxxxxxxxxxxxxxx` |
    | モデル | モデル名。タスクの複雑さに基づいて自動ルーティング | `auto` |
  </Tab>
</Tabs>

## 連携の確認

設定後、Hermesを起動して会話を開始します。

```bash theme={null}
hermes
```

または、よりモダンなTUIモード（ターミナルのグラフィカルインターフェース）を使用します。

```bash theme={null}
hermes --tui
```

テストメッセージを入力します。例：

```text theme={null}
Hello, what day is it today?
```

<Check>
  モデルが正常に応答すれば、連携は成功しています。
</Check>

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

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

```text theme={null}
/model
```

## FAQ

<Accordion title="空のレスポンスまたはエラー">
  ベースURLの末尾が`/v1`になっているか確認してください
</Accordion>

<Accordion title="モデルが見つからないエラー">
  モデル名がMixrouteコンソールのモデルIDと完全に一致していることを確認します
</Accordion>

<Accordion title="APIキーが無効というエラー">
  Mixrouteコンソールで新しいキーを生成し、`hermes model`を再実行してください
</Accordion>

<Accordion title="設定メニューへのアクセス方法がわからない">
  ターミナルで`hermes model`と入力し、Enterを押します
</Accordion>

<Accordion title="モデルを切り替えたい場合">
  `hermes model`を再度実行するか、会話内で`/model`を入力してください
</Accordion>

<Accordion title="以前の設定を変更したい場合">
  `hermes model`を再度実行すると、以前の設定が上書きされます。
</Accordion>

<Accordion title="Windowsにインストールできない">
  HermesはWindowsにネイティブ対応していません。先にWSL2をインストールし、WSL2のターミナルでインストールコマンドを実行してください
</Accordion>

<Info>
  Mixrouteとの連携後は、Hermes Agentの以降のすべての機能（メッセージングゲートウェイ、スキル呼び出し、バックグラウンドサービスなど）が、Mixroute経由で選択したモデルを呼び出します。機能ごとにモデルプロバイダーを個別に設定する必要はありません。
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.