HanaokaYuzu/Gemini-API

✨ Reverse-engineered Python API for Google Gemini web app

What it solves

This project provides a reverse-engineered asynchronous Python wrapper for the Google Gemini web app, allowing developers to interact with Gemini's web-based features programmatically without using the official API.

How it works

It utilizes asyncio for efficient task handling and requires authentication via browser cookies (__Secure-1PSID and __Secure-1PSIDTS). The library automatically refreshes these cookies in the background to maintain persistent sessions for always-on services. It can also automatically import cookies from Firefox via the browser-cookie3 dependency.

Who it’s for

Python developers who want to integrate Gemini's web-app capabilities—such as Gemini Gems, extensions, and multimodal generation—into their own applications or CLI tools.

Highlights

  • Multimodal Capabilities: Supports generating and editing images, as well as generating video and audio/music content.
  • Deep Research: Implements a full workflow for plan creation, status polling, and result retrieval.
  • Gemini Gems: Allows applying, creating, updating, and deleting custom system prompts (Gems).
  • Extension Support: Integrates with Gemini extensions like YouTube and Gmail.
  • Advanced Session Management: Features streaming mode for real-time responses, temporary chat modes, and the ability to retrieve a model's thought process.
  • Persistent Authentication: Automatically refreshes cookies to avoid frequent re-authentication.

Related

  • Project
    zexadev/gemini-web2api-go

    A Go server that reverse‑proxies Google Gemini’s web UI protocol and exposes it as an OpenAI‑compatible API (chat, models, streaming, video, image, music, web‑search). Works anonymously or with Google cookies, includes rate‑limiting, proxy & cookie pools, SQLite/MySQL persistence, and a lightweight admin UI.

  • Project
    Sophomoresty/gemini-web2api

    gemini‑web2api is a Python server that proxies Google Gemini’s private web API and presents it as an OpenAI‑compatible endpoint (`/v1/chat/completions`, `/v1/models`, etc.). It supports optional API‑key auth, streaming, function calling, image input, multiple Gemini model aliases, adjustable reasoning depth, and can run directly or inside Docker.

  • Project
    Nativu5/Gemini-FastAPI

    An OpenAI-compatible API wrapper for web-based Gemini models that allows free access using session cookies instead of an API key.

  • Project
    zhiyu1998/Gemi2Api-Server

    Gemi2Api‑Server is a FastAPI‑based bridge that lets you call Google Gemini via an OpenAI‑compatible REST API. It authenticates with Gemini using your browser cookies, forwards chat‑completion requests, optionally proxies generated images, and provides a simple admin UI. Deployable locally, via Docker, or on Render/HuggingFace, it’s useful for developers who want Gemini access without a formal public API.

  • Project
    googleapis/python-genai

    Python SDK for Google Gemini generative AI models, offering sync/async clients, type‑safe prompts, function calling, safety settings, and enterprise features.