Hermes は Nous Research のエージェントツールです。カスタムの OpenAI 互換エンドポイントに接続できるため、ローカルのエージェントワークフローで Novita LLM モデルを Hermes 内から使用できます。
前提条件
開始する前に、次の値を準備してください。
- API キー: Key Management から API キーを作成またはコピーします。
- Base URL:
https://api.novita.ai/openai/v1
- Model ID: 使用するモデル ID を Model Hub からコピーします(例:
deepseek/deepseek-v3.1)。
Hermes はエンドポイントと API キーの設定をローカルに保存します。API キーを含む生成済みの設定をコミットしないでください。
Hermes をインストールする
Hermes には、ターミナル版とデスクトップ版のインストールオプションがあります。ワークフローに合うものを選択してください。
Linux / macOS / WSL2
Windows PowerShell
デスクトップ
Hermes Desktop は以下からダウンロードすることもできます。
Novita エンドポイントを設定する
インストール後、Hermes のセットアップフローを実行します。正確なコマンドは Hermes のバージョンによって異なる場合があるため、インストールしたバージョンのターミナルプロンプトに従ってください。
セットアップ中は、次の選択肢と値を使用してください。
- Custom endpoint、またはプロバイダー URL を手動で入力できるオプションを選択します。
- Base URL を
https://api.novita.ai/openai/v1 に設定します。
- Novita API キーを入力します。
- API type では、デフォルトの自動検出オプションを維持します。手動で選択する必要がある場合は、OpenAI 互換または Chat Completions モードを選択します。
- リストからモデルを選択するか、
deepseek/deepseek-v3.1 などの Novita モデル ID を手動で入力します。
- モデルのコンテキスト長に基づいて max tokens を設定します。よくわからない場合は、デフォルト値または自動検出された値のままにします。
- モデル設定に、
novita-deepseek-v3.1 などの認識しやすい名前を付けます。
- Hermes をローカルでのみ実行したい場合は、デフォルトの Local runtime を選択します。
- Telegram、Slack、Matrix などのチャンネルが不要な場合は、統合チャンネルをスキップします。
シェルを再読み込みする
Hermes からシェルの再読み込みを求められた場合は、次を実行します。
Hermes を起動する
ターミナルから Hermes を起動します。
テストメッセージを送信します。例:
リクエストが失敗する場合は、次を確認してください。
- API キーが正しいこと。
- Base URL が
https://api.novita.ai/openai/v1 であること。
- モデル ID が Novita の Model Hub に表示されているものと一致していること。
- 選択した API type が OpenAI 互換エンドポイントに対応していること。