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

# Hermes

> Hermes を Novita の OpenAI 互換 LLM API エンドポイントに接続します。

Hermes は Nous Research のエージェントツールです。カスタムの OpenAI 互換エンドポイントに接続できるため、ローカルのエージェントワークフローで Novita LLM モデルを Hermes 内から使用できます。

## 前提条件

開始する前に、次の値を準備してください。

* **API キー**: [Key Management](https://novita.ai/settings/key-management) から API キーを作成またはコピーします。
* **Base URL**: `https://api.novita.ai/openai/v1`
* **Model ID**: 使用するモデル ID を Model Hub からコピーします（例: `deepseek/deepseek-v3.1`）。

<Tip>
  Hermes はエンドポイントと API キーの設定をローカルに保存します。API キーを含む生成済みの設定をコミットしないでください。
</Tip>

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

Hermes には、ターミナル版とデスクトップ版のインストールオプションがあります。ワークフローに合うものを選択してください。

### Linux / macOS / WSL2

```bash theme={"system"}
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

### Windows PowerShell

```bash theme={"system"}
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```

### デスクトップ

Hermes Desktop は以下からダウンロードすることもできます。

```text theme={"system"}
https://hermes-agent.nousresearch.com/desktop
```

## Novita エンドポイントを設定する

インストール後、Hermes のセットアップフローを実行します。正確なコマンドは Hermes のバージョンによって異なる場合があるため、インストールしたバージョンのターミナルプロンプトに従ってください。

セットアップ中は、次の選択肢と値を使用してください。

1. **Custom endpoint**、またはプロバイダー URL を手動で入力できるオプションを選択します。
2. Base URL を `https://api.novita.ai/openai/v1` に設定します。
3. Novita API キーを入力します。
4. API type では、デフォルトの自動検出オプションを維持します。手動で選択する必要がある場合は、OpenAI 互換または Chat Completions モードを選択します。
5. リストからモデルを選択するか、`deepseek/deepseek-v3.1` などの Novita モデル ID を手動で入力します。
6. モデルのコンテキスト長に基づいて max tokens を設定します。よくわからない場合は、デフォルト値または自動検出された値のままにします。
7. モデル設定に、`novita-deepseek-v3.1` などの認識しやすい名前を付けます。
8. Hermes をローカルでのみ実行したい場合は、デフォルトの Local runtime を選択します。
9. Telegram、Slack、Matrix などのチャンネルが不要な場合は、統合チャンネルをスキップします。

## シェルを再読み込みする

Hermes からシェルの再読み込みを求められた場合は、次を実行します。

```bash theme={"system"}
source ~/.zshrc
```

## Hermes を起動する

ターミナルから Hermes を起動します。

```bash theme={"system"}
hermes
```

テストメッセージを送信します。例:

```text theme={"system"}
Hello, briefly describe what coding tasks you can help with.
```

リクエストが失敗する場合は、次を確認してください。

* API キーが正しいこと。
* Base URL が `https://api.novita.ai/openai/v1` であること。
* モデル ID が Novita の Model Hub に表示されているものと一致していること。
* 選択した API type が OpenAI 互換エンドポイントに対応していること。