HanaokaYuzu/Gemini-API

✨ Reverse-engineered Python API for Google Gemini web app

What it solves

Google Gemini Web アプリ（旧 Bard）とプログラムからやり取りできる手段を提供します。逆コンパイルされた非同期 Python ラッパーを使用することで、公式 API に依存せずに Gemini の Web 機能を利用できます。

How it works

このライブラリは Gemini の Web インターフェースをラップします。認証にはセッション Cookie（__Secure-1PSID と __Secure-1PSIDTS）を使用し、asyncio を用いた非同期クライアントでリクエスト送信とレスポンス受信を行います。バックグラウンドで Cookie を自動更新し、常時稼働サービス向けに永続セッションを維持します。

Who it’s for

画像・動画・音声生成、ディープリサーチ、Gemini Gems など、Gemini の Web アプリ機能を自分のアプリやスクリプトに組み込みたい Python 開発者向けです。

Highlights

  • Multimodal Capabilities: 画像の生成・編集に加え、動画や音声／音楽コンテンツの生成もサポート。
  • Deep Research: 計画作成、ステータスのポーリング、結果取得までのフルワークフローを実装。
  • Gemini Gems Support: カスタムシステムプロンプト（Gems）の適用、作成、更新、削除が可能。
  • Extension Integration: YouTube や Gmail など Gemini 拡張機能の利用をサポート。
  • Advanced Session Management: 永続 Cookie と自動リフレッシュ、会話を履歴に保存しない一時モードを提供。
  • Developer‑Friendly: CLI ツール、リアルタイム応答のストリーミングモード、公式 Google Generative AI API にインスパイアされたインターフェースを含む。