Google Gemini

Hermes Agent は Google Gemini を、Google AI Studio / Gemini API を使ったネイティブのプロバイダとして扱います。OpenAI 互換のエンドポイントではありません。これによって Hermes は、内部で使っている OpenAI 形式のメッセージとツールのやり取りを Gemini 本来の generateContent API へ変換しつつ、ツール呼び出し、ストリーミング、画像などの入力、Gemini 独自の応答情報をそのまま活かせます。

事前に必要なもの

Google AI Studio の API キー — aistudio.google.com/apikey で作成します
課金を有効にした Google Cloud プロジェクト — エージェント用途ではこちらをおすすめします。Hermes は利用者の 1 回の発言に対してモデルを何度も呼ぶことがあるため、Gemini の無料枠では長く続くセッションには足りません。
Hermes の導入 — ネイティブの Gemini プロバイダに、追加の Python パッケージは要りません。

すぐ試す

# Add your Gemini API key
echo "GOOGLE_API_KEY=..." >> ~/.hermes/.env

# Select Gemini as your provider
hermes model
# → Choose "More providers..." → "Google AI Studio"
# → Hermes checks your key tier and shows Gemini models
# → Select a model

# Start chatting
hermes chat

設定ファイルを直接書くほうがよければ、ネイティブの Gemini API のベース URL を指定します。

model:
  default: gemini-3.7-flash
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

設定

hermes model を実行したあと、~/.hermes/config.yaml は次のようになります。

model:
  default: gemini-3.7-flash
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

そして ~/.hermes/.env には次が入ります。

GOOGLE_API_KEY=...

ネイティブの Gemini API

おすすめのエンドポイントはこちらです。

https://generativelanguage.googleapis.com/v1beta

Hermes はこのエンドポイントを見分けて、ネイティブの Gemini アダプタを用意します。内部ではエージェントのやり取りを OpenAI 形式のメッセージのまま保ちつつ、リクエストのたびに Gemini 本来の形へ変換します。

messages[] → Gemini の contents[]
システムプロンプト → Gemini の systemInstruction
ツールの定義 → Gemini の functionDeclarations
ツールの実行結果 → Gemini の functionResponse パート
ストリーミングの応答 → Hermes の処理用に OpenAI 形式のチャンクへ

ネイティブのエンドポイントを選ぶ

Google は OpenAI 互換のエンドポイントも公開しています。

https://generativelanguage.googleapis.com/v1beta/openai/

Hermes のエージェントとして使うなら、上のネイティブの Gemini エンドポイントを選んでください。Hermes にはネイティブの Gemini アダプタが入っていて、複数ターンにわたるツールの利用、ツールの実行結果、ストリーミング、画像などの入力、Gemini の応答情報を、Gemini の generateContent API へ直接対応づけられます。OpenAI 互換のエンドポイントが役に立つのは、OpenAI の API との互換性そのものが必要な場面です。

以前に GEMINI_BASE_URL を /openai の URL にしていた場合は、削除するか書き換えてください。

GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta

使えるモデル

hermes model の選択画面には、Hermes のプロバイダ登録簿にある Gemini のモデルが並びます。よく使われるのは次のあたりです。

モデル	ID	補足
Gemini 3.7 Flash	`gemini-3.7-flash`	速さ、性能、画像などの理解のバランスが良く、既定としておすすめ
Gemini 3.1 Pro Preview	`gemini-3.1-pro-preview`	推論、数学、コーディングがもっとも得意
Gemini 3.5 Flash Lite	`gemini-3.5-flash-lite`	軽い作業向けに、もっとも速く、もっとも安い
Gemini 2.5 Flash	`gemini-2.5-flash`	前の世代の高速モデル。思考する機能あり
Gemini 2.5 Pro	`gemini-2.5-pro`	前の世代の、複雑な推論向けモデル

どのモデルが使えるかは時期によって変わります。モデルが見当たらない、あるいは手元のキーで有効になっていない場合は、hermes model をもう一度実行して、そのときの一覧から選んでください。

latest 系の別名

Google は Gemini の Pro 系と Flash 系に、指す先が移り変わる別名を用意しています。gemini-pro-latest と gemini-flash-latest は、Hermes の設定を書き換えずに Google 側でモデルを新しくしてほしいときに便利です。ただし、新しいモデルの料金が違えば、支払う金額も変わる点には注意してください。

別名	現在指しているもの	補足
`gemini-pro-latest`	最新の Gemini Pro モデル	Google が今すすめている Pro を使いたいときに
`gemini-flash-latest`	最新の Gemini Flash モデル	Google が今すすめている Flash を使いたいときに

model:
  default: gemini-pro-latest
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

毎回きっちり同じ結果を求めるなら、gemini-3.1-pro-preview や gemini-3.7-flash のように、モデル ID を明示するほうが向いています。

Gemini API 経由の Gemma

Google は Gemma のモデルも Gemini API から公開しています。Hermes はこれらを Google のモデルとして認識しますが、処理量がごく限られる Gemma の項目は既定の選択画面から隠します。使い始めたばかりの人が、長く続くエージェントのセッションに評価用のモデルをうっかり選んでしまわないようにするためです。

評価に使える ID には次のようなものがあります。

モデル	ID	補足
Gemma 4 31B IT	`gemma-4-31b-it`	大きめの Gemma。互換性や品質の評価に向く
Gemma 4 26B A4B IT	`gemma-4-26b-a4b-it`	有効パラメータの少ない小型版。使える場合に

これらは、Gemini API のキーで試せる評価用の選択肢と考えるのがよいでしょう。Google の Gemma API の料金は無料枠だけで、使用量の上限も実運用向けの Gemini モデルに比べて低めです。エージェントとして継続的に使うなら、有料の Gemini モデル、自前で立てた環境、あるいは十分な枠のある別のプロバイダへ移るのが普通です。

選択画面に出てこない Gemma を使いたいときは、直接指定します。

model:
  default: gemma-4-31b-it
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

会話の途中でモデルを切り替える

会話中に /model コマンドを使います。

/model gemini-3.7-flash
/model gemini-flash-latest
/model gemini-3.1-pro-preview
/model gemini-pro-latest
/model gemma-4-31b-it
/model gemini-3.1-flash-lite-preview

まだ Gemini を設定していない場合は、いったんセッションを終了して hermes model を先に実行してください。/model は設定済みのプロバイダとモデルの間で切り替えるだけで、新しい API キーを受け取ることはありません。

状態を調べる

hermes doctor

このコマンドが確認するのは次の点です。

GOOGLE_API_KEY または GEMINI_API_KEY が使える状態にあるか
設定したプロバイダの認証情報を解決できるか

ゲートウェイ（メッセージングのサービス）

Gemini は Hermes のゲートウェイが対応するすべてのサービス（Telegram、Discord、Slack、WhatsApp、LINE、Feishu など）で使えます。Gemini をプロバイダとして設定したら、あとは普段どおりゲートウェイを起動します。

hermes gateway setup
hermes gateway start

ゲートウェイは config.yaml を読み、同じ Gemini の設定をそのまま使います。

困ったときは

「Gemini native client requires an API key」と出る

Hermes が使える API キーを見つけられませんでした。次のどちらかを ~/.hermes/.env に追加してください。

GOOGLE_API_KEY=...
# or
GEMINI_API_KEY=...

そのうえで hermes model をもう一度実行します。

「This Google API key is on the free tier」と出る

Hermes は初期設定のときに Gemini の API キーを調べます。ツールの利用、やり直し、圧縮、補助的な処理でモデルを何度も呼ぶことがあるため、無料枠だと数ターンで使い切ってしまうことがあります。

キーに紐づく Google Cloud プロジェクトで課金を有効にし、必要ならキーを作り直してから、次を実行してください。

hermes model

「404 model not found」と出る

選んだモデルが、そのアカウント、地域、またはキーでは使えません。hermes model をもう一度実行して、そのときの一覧から別の Gemini モデルを選んでください。

`hermes model` に Gemma のモデルが出てこない

Hermes は、処理量の少ない Gemma のモデルを既定で選択画面から隠すことがあります。あえて評価したい場合は、~/.hermes/config.yaml にモデル ID を直接書いてください。

Gemma で「429 quota exceeded」と出る

Gemini API から使える Gemma のモデルは評価には便利ですが、Gemini API の無料枠の上限は低めです。互換性の確認に使ったら、継続的に動かすときは有料の Gemini モデルか別のプロバイダに切り替えてください。

OpenAI 互換のエンドポイントが設定されている

~/.hermes/.env に次の行がないか確認してください。

GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/

ネイティブのエンドポイントに書き換えるか、この上書き設定を削除します。

GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta

ツール呼び出しがスキーマのエラーで失敗する

Hermes を新しくして、hermes model をやり直してください。ネイティブの Gemini アダプタは、Gemini の厳しめな関数定義の形式に合わせてツールのスキーマを整えます。古い版や独自のエンドポイントでは、この処理が入っていないことがあります。

AI プロバイダ
設定
予備のプロバイダ
AWS Bedrock — AWS の認証情報を使う、クラウド事業者ネイティブの連携