Hermes Agent 設定ガイド

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

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

ソースコードアドレス

GitHub：NousResearch/hermes-agent
公式ドキュメント：hermes-agent.nousresearch.com/docs

1. Hermes Agent をインストール

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

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

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

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

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

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 に向けます：

model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "gpt-5.5"

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

hermes config set model.provider custom
hermes config set model.base_url https://llmoxy.com/v1
hermes config set model.model gpt-5.5

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

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

OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx

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

hermes config set OPENAI_API_KEY <LLMOXY_API_KEY>xxxxxxxxxxxxxxx

<LLMOXY_API_KEY>xxxxxxxxxxxxxxx を LLMoxy コンソールから取得した実際のトークンに置き換えてください。

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

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

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

hermes model

順番に選択：

プロバイダーオプションで Custom Endpoint を選択
Base URL に https://llmoxy.com/v1 を入力
API Key に LLMoxy トークンを貼り付け
モデルに gpt-5.5（または LLMoxy がサポートする他のモデル ID、例：gpt-5.4）を入力

4. Hermes を起動

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

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

完全な設定例

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "gpt-5.5"

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

💡 モデル命名規則のヒント gpt-5.5 は LLMoxy 上の標準モデル ID で、コンソールの「モデルリスト」で確認できます。その他の常用モデル：

GPT シリーズ：gpt-5.5、gpt-5.4、gpt-4o

Claude シリーズ：claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5

Gemini シリーズ：gemini-2.5-pro

設定優先順位

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

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

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