🤖HermesBlog
Hermes 実践ガイド · パート 208/9/2026

Google Gemini を接続する

Google Gemini を接続する — 公式ドキュメントに基づく分かりやすいガイド

Hermes Agent を、まるで万能リモコンのように考えてみてください。さまざまなAIサービスを操作できますが、今回はその中でも、Googleの強力なAIモデルである Google Gemini とペアリングしてみましょう。

guide-google-gemini

なぜHermesでGeminiを使うのか？

Geminiは高速で賢く、テキスト、画像、さらには動画まで得意としています。これをHermesに接続すると、ウェブを閲覧したり、ツールを使ったり、長い会話の文脈を記憶したりできるAIエージェントを、Geminiの頭脳で動かすことができます。

さらに嬉しいのは、HermesがGeminiと話すとき、翻訳レイヤーを介さずに、Gemini自身のネイティブな言語（API）で直接会話する点です。これにより、ツール呼び出しがスムーズになり、ストリーミングも最適化され、複雑なタスクを実行する際のエラーも少なくなります。

必要なもの

始める前に、以下の3つを用意してください。

  1. Google AI Studio の API キー – aistudio.google.com/apikey で無料で取得できます。
  2. 課金が有効な Google Cloud プロジェクト – 推奨されます。無料枠は長時間のエージェントセッションには小さすぎるためです。
  3. インストール済みの Hermes – 追加のパッケージは必要ありません！

ステップ 1: API キーを追加する

ターミナルを開き、Hermesの環境ファイルにキーを追加します。

echo "GOOGLE_API_KEY=your_api_key_here" >> ~/.hermes/.env

Hermesは GOOGLE_API_KEY と GEMINI_API_KEY の両方をチェックするので、どちらでも動作します。

ステップ 2: プロバイダーとして Gemini を選択する

以下のコマンドを実行して、モデルピッカーを開きます。

hermes model

次に、以下の手順に従います。

  • 「More providers…」 を選択します。
  • 「Google AI Studio」 を選択します。
  • Hermesがキーを確認し、利用可能なGeminiモデルを表示します。
  • モデル（例：gemini-3-flash-preview）を選択します。

ステップ 3: チャットを開始する

選択が完了したら、以下のコマンドを実行するだけです。

hermes chat

これで完了です！ これであなたはHermesを通じてGeminiと会話できます。

舞台裏では何が起こっているのか？

設定ファイル（~/.hermes/config.yaml）を覗いてみると、次のような内容が表示されます。

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

これは、HermesにGeminiのネイティブエンドポイントを使用するように指示しています。Hermesは内部メッセージを自動的にGeminiの形式に変換するため、技術的な詳細を心配する必要はありません。

エンドポイントに関する簡単な注意点

GoogleはOpenAI互換のエンドポイントも提供しています。しかし、Hermesでは常にネイティブエンドポイント（https://generativelanguage.googleapis.com/v1beta）を優先してください。ネイティブアダプターを使用すると、ツール呼び出し、ストリーミング、メタデータサポートが向上し、エージェントを確実に動作させることができます。

以前に GEMINI_BASE_URL を /openai URLに設定した場合は、元に戻してください。

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

まとめ

GeminiをHermesに接続するのは1分もかかりません。

  1. ~/.hermes/.env にAPIキーを追加します。
  2. hermes model を実行し、Google AI Studioを選択します。
  3. モデルを選択して、チャットを開始します。

実用的なヒント： まずは無料枠でテストし、実際のエージェントタスクを実行する際には、課金が有効なプロジェクトに切り替えましょう。エージェントがターンごとに複数回呼び出しを行うと、Geminiの無料枠はすぐに使い果たされてしまいます。後で後悔しないように！

📖 公式ドキュメント

この記事は Hermes Agent の公式ドキュメントに基づいています：公式ドキュメント › guides/google-gemini

← すべての記事に戻る