FastMetal

Hermes

HermesはNous Researchが開発する自律型のコーディングエージェントです。OpenAI互換のエンドポイントであれば接続できるため、FastMetalをそのまま推論先として設定できます。CLIとTUIの両方が用意されています。

インストール

インストーラーがuv、Python、Node.js、ripgrepなどの依存関係をまとめて導入します。

macOS / Linux / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

設定ウィザードで接続する

推奨する方法です。ターミナルで次のコマンドを実行し、カスタムエンドポイントとしてFastMetalを登録します。

hermes model
1.「Custom endpoint (self-hosted / VLLM / etc.)」を選択します。
2.API base URL に https://api.fastmetal.ai/v1 を入力します。
3.API key にFastMetalのAPIキーを入力します。
4.Model name にモデル一覧ページに記載のモデル名（例: anthropic-claude-sonnet-5）を入力します。

config.yaml で直接設定する

ウィザードを使わずに設定ファイルを直接編集することもできます。provider に custom を指定すると、base_url のエンドポイントが使われます。

~/.hermes/config.yaml
# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: https://api.fastmetal.ai/v1
  default: anthropic-claude-sonnet-5

APIキーは config.yaml に直接書くこともできますが、秘匿情報は .env に置くことが推奨されています。model.api_key を省略した場合、Hermesは OPENAI_API_KEY を参照します。

~/.hermes/.env
# ~/.hermes/.env
OPENAI_API_KEY=your-fastmetal-api-key

名前付きプロバイダーとして登録する

複数のエンドポイントを併用する場合は、providers に名前を付けて登録しておくと便利です。セッション中の切り替えが容易になり、補助モデルの指定にもこの名前を使えます。

~/.hermes/config.yaml
# ~/.hermes/config.yaml
providers:
  fastmetal:
    api: https://api.fastmetal.ai/v1
    key_env: FASTMETAL_API_KEY
    transport: chat_completions
    default_model: anthropic-claude-sonnet-5

model:
  provider: custom:fastmetal
  default: anthropic-claude-sonnet-5
~/.hermes/.env
# ~/.hermes/.env
FASTMETAL_API_KEY=your-fastmetal-api-key

FastMetalはAnthropic互換のエンドポイントも提供しています。Anthropic形式で接続する場合は、transport に anthropic_messages を指定してください。両方を登録しておき、用途に応じて切り替えることもできます。

~/.hermes/config.yaml
providers:
  fastmetal-anthropic:
    api: https://api.fastmetal.ai/anthropic/v1
    key_env: FASTMETAL_API_KEY
    transport: anthropic_messages
    default_model: anthropic-claude-sonnet-5

モデルを切り替える

セッション中は /model コマンドでモデルを切り替えられます。名前付きプロバイダーの場合は custom:プロバイダー名:モデル名 の形式で指定します。

/model custom:fastmetal:glm-5.2
/model custom:fastmetal:deepseek-v4-flash
/model custom:fastmetal:anthropic-claude-opus-5

補助モデルを指定する

Hermesは会話タイトルの生成、履歴の圧縮、画像の解釈といった補助的な処理を別のモデルで実行します。これらに安価で高速なモデルを割り当てておくと、全体のコストを抑えられます。

~/.hermes/config.yaml
auxiliary:
  title_generation:
    provider: fastmetal
    model: gemini-3.5-flash
  compression:
    provider: fastmetal
    model: gemini-3.5-flash
  vision:
    provider: fastmetal
    model: anthropic-claude-sonnet-5

コンテキスト長の指定

コンテキスト長は通常、エンドポイントのモデル情報から自動的に判定されます。判定結果が実際と異なる場合や、意図的に上限を下げたい場合は明示的に指定してください。Hermesはこの値をもとに履歴を圧縮するタイミングを決めます。

~/.hermes/config.yaml
model:
  provider: custom:fastmetal
  default: anthropic-claude-sonnet-5
  context_length: 200000

起動する

設定が完了したら、Hermesを起動します。TUIを使う場合は --tui を付けてください。以降のリクエストはすべてFastMetal経由となり、使用したキーの残高から差し引かれます。

hermes          # CLI
hermes --tui    # TUI

運用のヒント

トラブルシューティング

401 認証エラー

APIキーが正しく渡されていません。key_env を使っている場合は、~/.hermes/.env に該当の環境変数が定義されているかご確認ください。キー自体の有効性は、同じキーで /v1/models にリクエストを送ると確認できます。

モデルが見つからない

モデル名はFastMetalに登録されている識別子と完全に一致する必要があります。提供元での名称ではなく、モデル一覧ページまたは /models エンドポイントが返す名前をご利用ください。

リクエストが429で拒否される

キーの残高を使い切った可能性があります。応答に budget_exceeded が含まれている場合は、ダッシュボードからクレジットを追加購入してください。追加後はすぐに再開できます。