# HanaokaYuzu/Gemini-API

✨ Reverse-engineered Python API for Google Gemini web app

Repository: https://github.com/HanaokaYuzu/Gemini-API
Canonical: https://ross.abutalabs.com/products/gemini-api
Homepage: https://pypi.org/project/gemini-webapi/
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: ai, api, async, bard, chatbot, gemini, generative-ai, google, llm, python, imagefx, google-gemini, reverse-engineering, image-generation, nano-banana
Last push: 2026-08-24T10:13:28+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 66
- inputs: {"age_days": 934, "days_push": 9, "days_rel": 18, "gap_med": 10, "n_releases_24m": 42}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3437, forks 545 (observed 2026-08-28T04:08:04.986741+00:00)

## What it is
A reverse-engineered asynchronous Python client library for Google's Gemini web app (formerly Bard), published as gemini-webapi on PyPI. It wraps the web interface to provide chat, image/video/audio generation, deep research, streaming, and cookie-based authentication without an official API key.

## Use cases
- chat with gemini from python without an api key
- generate images with gemini programmatically
- build a chatbot using the gemini web app
- stream gemini responses asynchronously
- run deep research queries via gemini
- generate videos or audio with gemini web
- automate gemini interactions from the command line

## When to choose
- you want free access to Gemini features without official API billing
- you need async Python access to Gemini web capabilities like image generation or Gems
- you want an interface mirroring the official Google Generative AI SDK

## When to avoid
- you need a stable, officially supported API for production
- you cannot accept the risk of breakage from Google changing the web app
- your project's license is incompatible with AGPL-3.0

## Facets
- artifact type: library
- maturity: active
- function: http-client, llm-inference, chatbot, image-processing, reverse-engineering, sdk
- domain: large-language-models, artificial-intelligence, chatbots, apis
- platform: python, cli, cross-platform
- tags: gemini, bard, google-gemini, webapi, async, image-generation, unofficial-api, generative-ai

## Member repositories
- HanaokaYuzu/Gemini-API (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:04.986741+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:37:41.139659+00:00, confidence not recorded.
  - readme: https://github.com/HanaokaYuzu/Gemini-API (fetched 2026-08-28T04:08:04.986741+00:00, sha 657a4e0b3c53)
  - homepage: https://pypi.org/project/gemini-webapi/ (fetched 2026-08-29T09:31:50.670148+00:00, sha 4b4e8fead74a)
- Data as of 2026-08-30T08:39:29.467469+00:00.