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 が含たれおいる堎合は、ダッシュボヌドからクレゞットを远加賌入しおください。远加埌はすぐに再開できたす。