Hermes Agent

Hermes Agent のモデルリクエストを TokenHub 経由にする設定です。

Hermes Agent は TokenHub の OpenAI compatible 互換 API ゲートウェイ経由でモデルリクエストを送信できます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。

このガイドで使う TokenHub endpoint は https://us-api.tokenhub.com/v1/chat/completions です。

使う場面

小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。

インストールまたは起動

まず Hermes Agent 公式ドキュメントに従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。

CLI ツールの場合、TokenHub 認証情報を追加する前に実行ファイルが使えることを確認します：

hermes --version

TokenHub 認証情報を準備

TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。

export TOKENHUB_API_KEY="sk-..."

キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。

TokenHub プロバイダーを設定

Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。

Provider の値

項目	値
プロバイダー	OpenAI Compatible または Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` の値
モデル	`gpt-4.1` または別の TokenHub model ID

設定ファイルの場所

項目	値
Secret	`~/.hermes/.env`
Provider and model config	`~/.hermes/config.yaml`
Named custom provider	`tokenhub-custom`

TOKENHUB_API_KEY=sk-...

custom_providers:
  - name: tokenhub-custom
    base_url: '__API_BASE_URL__/v1'
    key_env: TOKENHUB_API_KEY
    api_mode: chat_completions

model:
  provider: 'custom:tokenhub-custom'
  default: 'gpt-4.1'

This follows Hermes' current named custom provider schema: base_url is the OpenAI-compatible Base URL, key_env reads the secret without writing it into YAML, and api_mode: chat_completions selects /v1/chat/completions.

Always keep the custom: prefix. Hermes treats bare tokenhub as a built-in provider alias; custom:tokenhub-custom unambiguously selects this self-hosted endpoint.

/model custom:tokenhub-custom:gpt-4.1

hermes chat

Hermes stores the named custom provider, Base URL, API mode, and default model in ~/.hermes/config.yaml. The API key remains in ~/.hermes/.env. You can also run hermes model, select Custom Endpoint, and enter the same values interactively.

ツールが chat、edit、apply、fast model を分けている場合、最初のテストでは同じ TokenHub モデルを使います。動作確認後にコスト、レイテンシ、推論力で分けます。

一時環境変数はデバッグ用

一時変数は key、ネットワーク、モデル名の確認にだけ使います。確認後は同じ値を上の永続設定に移してください。

export TOKENHUB_API_KEY="sk-..."

接続を確認

まず読み取り専用のプロンプトで、モデルが文脈を読めること、ファイルを変更しないことを確認します。その後、編集や Agent タスクを試します。

このプロジェクトの README を読み、3 文で要約してください。ファイルは変更しないでください。

プロンプトが成功したら、TokenHub のリクエストログでモデル名、endpoint、token 使用量、課金グループを確認します。

トラブルシューティング

症状	対処
401 または認証失敗	`TOKENHUB_API_KEY` が有効で、同じ terminal、IDE、クライアントプロファイルに保存されているか確認します。
404 またはモデルが見つからない	TokenHub ワークスペースに存在し、選択したプロトコルに対応するモデル ID を使います。
endpoint が違う	上記の Base URL と完全に一致させます。OpenAI 互換ツールは通常 `/v1` が必要で、Claude 互換ツールは通常不要です。
リクエストがタイムアウトする	`https://us-api.tokenhub.com` へのネットワーク、プロキシ設定、ワークスペースの allowlist を確認します。
別のモデルが使われる	chat、edit、apply、fast、autocomplete など全てのモデル欄を再確認します。

このページの目次