# Hermes Agent 設定ガイド

> ~/.hermes/config.yaml と .env を介して Hermes Agent のカスタムプロバイダーを LLMoxy に向け、GPT / Claude / Gemini 全シリーズモデルに接続します。

ウェブサイト：[https://hermes-agent.nousresearch.com（クリックしてジャンプ！）](https://hermes-agent.nousresearch.com)

> **📌 Hermes Agent について**
> Hermes Agent は Nous Research が発売したオープンソースターミナル AI エージェントで、CLI / TUI / API Server の 3 つのエントリーポイントをサポートし、任意の OpenAI 互換エンドポイントに接続できます。

## ソースコードアドレス

- GitHub：[NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)
- 公式ドキュメント：[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs)

## 1. Hermes Agent をインストール

### 方法 1：pip インストール（推奨）

```bash
pip install hermes-agent
hermes postinstall    # オプション：Node.js / ブラウザ / ripgrep / ffmpeg の自動インストール
```

### 方法 2：スクリプトインストール（main ブランチに追従）

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

インストール完了後、Shell をリロード：

```bash
source ~/.zshrc    # または source ~/.bashrc
```

## 2. コア設定フロー

Hermes Agent の設定は `~/.hermes/` ディレクトリに集中しています：

| ファイル | 用途 |
| --- | --- |
| `~/.hermes/config.yaml` | モデル、プロバイダー、ターミナル、圧縮などすべての非機密設定 |
| `~/.hermes/.env` | API Key などの機密認証情報 |

### 1. config.yaml を設定（カスタムプロバイダー）

`~/.hermes/config.yaml` を開くか作成し、`model` ブロックを `custom` プロバイダーとして記述し、`base_url` を LLMoxy に向けます：

```yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "grok-4.7"
```

CLI でのワンクリック書き込みも可能（自動的に `config.yaml` に反映）：

```bash
hermes config set model.provider custom
hermes config set model.base_url https://llmoxy.com/v1
hermes config set model.model grok-4.7
```

### 2. .env を設定（API Key を書き込み）

LLMoxy トークンを `~/.hermes/.env` に書き込みます：

```
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

または CLI を使用（推奨。自動的に `.env` にルーティングされ、YAML に漏洩しません）：

```bash
hermes config set OPENAI_API_KEY <LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

`<LLMOXY_API_KEY>xxxxxxxxxxxxxxx` を [LLMoxy コンソール](https://llmoxy.com/) から取得した実際のトークンに置き換えてください。

> **💡 ヒント**
> **auto** グループのトークンを使用してください。Hermes Agent は OpenAI Chat Completions プロトコルで LLMoxy を呼び出します。`base_url` は `/v1` を含む必要があります。

## 3. インタラクティブクイック設定（オプション）

YAML を手動で編集したくない場合は、`hermes model` を実行してインタラクティブウィザードに入ります：

```bash
hermes model
```

順番に選択：

1. プロバイダーオプションで **Custom Endpoint** を選択
2. Base URL に `https://llmoxy.com/v1` を入力
3. API Key に LLMoxy トークンを貼り付け
4. モデルに `grok-4.7`を入力

## 4. Hermes を起動

```bash
hermes          # クラシック CLI
hermes --tui    # モダン TUI インターフェース（推奨）
```

起動後、ウェルカムバナーに現在アクティブなモデルとプロバイダーが表示されます。テスト prompt を入力して接続性を検証できます。

## 完全な設定例

```yaml
# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "grok-4.7"
```

```
# ~/.hermes/.env
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

> **💡 モデル命名規則のヒント**
> `grok-4.7` は LLMoxy 上の標準モデル ID で、コンソールの「モデルリスト」で確認できます。その他の常用モデル：
> - **GPT シリーズ**：`gpt-6.1-sol`
> - **Claude シリーズ**：`claude-opus-5-5`、`claude-fable-5-2`

## 設定優先順位

Hermes Agent は以下の優先順位（高い順）で設定を読み取ります：

1. コマンドラインパラメータ
2. `~/.hermes/config.yaml`
3. `~/.hermes/.env`
4. 組み込みデフォルト値

設定変更後、Hermes を再起動する必要はありません。次の新しいセッションが自動的に最新の `config.yaml` を読み込みます。

これは https://jp.llmoxy.com/docs/code-tutorials/hermes-agent の markdown 版です。
