Flaq AI エージェントガイド

Flaq AI の API サービスで Hermes Agent を使う実践ガイド

Flaq AI の Hermes Agent 互換エンドポイントを使うと、Hermes Agent を Flaq 向けにすばやく設定し、ターミナルからモデルサービスにアクセスできます。API キーを設定したら、このガイドの例に沿って現在サポートされているモデルを選び、セットアップを検証してください。

エージェントガイド

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

インストール

Hermes Agent をインストールする

お使いのシステム向けに Hermes Agent をインストールし、必要に応じてシェルを再読み込みしてから、Flaq AI 設定を追加する前に hermes コマンドを検証します。インストーラーがセットアップウィザードを開く場合は、Nous Portal ログインをスキップして、その後で Flaq を手動設定できます。

1

Hermes Agent をインストールする

お使いのシステムに合うインストーラーを選び、以下のインストールコマンドを実行します。

インストーラーが Hermes セットアップウィザードを開く場合があります。Flaq セットアップでは、Nous Portal ログインをスキップして、下の手動設定に進めます。

公式インストールスクリプト

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
2

シェルプロファイルを再読み込みする

インストール後、まだ hermes コマンドを利用できない場合に実行します。シェルが bash を使っている場合は source ~/.bashrc を使ってください。

シェルプロファイルを再読み込みする

source ~/.zshrc
3

Hermes Agent を検証する

Flaq AI の認証情報を追加する前に、hermes コマンドを利用できることを確認します。

インストールを検証する

hermes --version

設定

Hermes Agent を Flaq AI に接続する

Flaq の OpenAI 互換エンドポイントで現在サポートされているモデルを選び、Flaq API キーを ~/.hermes/.env に保存し、config.yaml の向き先を Flaq API ベース URL に設定します。

信頼できる既定の Hermes Agent コーディングワークフローに推奨されるテキストモデルです。

Hermes CLI コマンドを使い、少ない手動ファイル編集で Flaq API キーとモデル設定を書き込みます。これはローカルの Hermes 設定を更新するため、すでに Hermes を使っている場合は先に既存設定をバックアップしてください。

Hermes config コマンドを通じて、Flaq キー、選択したモデル、カスタムプロバイダー、ベース URL、コンテキスト長を書き込みます。

Hermes CLI クイックセットアップ

hermes config set FLAQ_API_KEY Your_Api_Keyhermes config set model.default gpt-5.4-text-to-texthermes config set model.provider customhermes config set model.base_url https://api.flaq.ai/api/v1hermes config set model.api_key '${FLAQ_API_KEY}'hermes config set model.context_length 128000hermes config check

検証

Hermes Agent で Flaq を検証する

Hermes の簡単なワンショットコマンドを実行します。通常の回答が返れば、Hermes は Flaq LLM エンドポイント経由でモデルを呼び出せています。

インタラクティブモードを開始する

hermes

クイックテストコマンド

hermes -m gpt-5.4-text-to-text -z "What is 2+2?"

設定診断

hermes config check

選択したモデルを既定値として設定する

hermes config set model.default gpt-5.4-text-to-text

トラブルシューティング

Hermes Agent FAQ

このガイドの設定で使用すると、token 使用量が大幅に増える可能性があります。