Google Gen AI SDK review
Google Gen AI SDK is a Python library for integrating Google's generative models into applications through the Gemini Developer API or Gemini Enterprise Agent Platform.
TL;DR
Google Gen AI SDK is Google's Python SDK for calling Gemini models from Python applications. It is for developers using either the Gemini Developer API with an API key or Gemini Enterprise Agent Platform with a Google Cloud project. One client covers text, image and audio generation, file uploads, function calling, and sync or async use.
- 4kGitHub stars
- +11new stars, week of Oct 25
- ~67.8Mdownloads a week, +4% vs 4-week avg
- #14in Model SDKs and gateways this week
Google Gen AI SDK at a glance
- Category
- Model SDKs and gateways
- Maintained by
- Google APIs (organization, @googleapis on GitHub)
- License
- Apache 2.0
- Language
- Python
- Repository
- github.com/googleapis/python-genai
- Website
- googleapis.github.io/python-genai
- npm package
- @google/genai 2.30.0
- PyPI package
- google-genai 2.32.0
- Latest release
- v2.32.0 on GitHub, Oct 21, 2026
- First published
- Dec 6, 2024
What Google Gen AI SDK does
- Google Gen AI SDK generates content from Gemini models with text input and text output through client.models.generate_content.
- Google Gen AI SDK can request image output or audio and speech output by setting response modalities in GenerateContentConfig.
- Google Gen AI SDK uploads files and uses them in prompts on the Gemini Developer API.
- Google Gen AI SDK accepts parameters as Pydantic models from google.genai.types or as plain dictionaries.
- Google Gen AI SDK provides sync and async clients, with context managers that close the underlying HTTP connections.
- Google Gen AI SDK supports function call parts, automatic function calling through Chats, and a Live API module.
- Google Gen AI SDK lets you select API versions such as v1 or v1alpha and set proxies or a custom base URL.
How it works
Google Gen AI SDK runs inside your Python code. You create a genai.Client with an API key for the Gemini Developer API, or with enterprise=True, a project and a location for Agent Platform. Environment variables can supply these settings instead. The SDK calls beta API endpoints by default and uses httpx for HTTP, with aiohttp available as an optional async backend.
How to install and start using Google Gen AI SDK
With pip
pip install google-genaiWith uv
uv pip install google-genaiRequirements
- Python 3.10 or later.
- A Gemini API key (GEMINI_API_KEY or GOOGLE_API_KEY) for the Gemini Developer API.
- A Google Cloud project ID and location for Gemini Enterprise Agent Platform.
First steps
- Install the package, then import it with from google import genai and from google.genai import types.
- Set GEMINI_API_KEY, or set GOOGLE_GENAI_USE_ENTERPRISE, GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION for Agent Platform.
- Create a client with genai.Client(), then call client.models.generate_content with a model such as gemini-flash-latest.
- Close the client with client.close(), or use a with block so the client closes automatically.
Who Google Gen AI SDK is for
- Teams that may move between the Gemini Developer API and Gemini Enterprise Agent Platform using one client.
- Async Python services that need an async client, with optional aiohttp for faster performance.
Limitations to know
- Google Gen AI SDK's next major version changes automatic function calling and removes several Live and Models fields. Pin to < 3.0.0 to avoid this.
- Google Gen AI SDK's file upload example is marked as available on the Gemini Developer API only.
- Google Gen AI SDK uses beta API endpoints by default. Stable endpoints require setting the API version to v1.
- Google Gen AI SDK only works with Google's generative models through Google's APIs.
Is Google Gen AI SDK growing? Usage data
In the week of Oct 25–31, 2026, Google Gen AI SDK ranked #250 on the Devtoolwatch Board and #14 in Model SDKs and gateways, with a momentum score of 38 out of 100. Its main package had about 67.8M downloads that week, +4% against its own 4-week average.
Show the weekly numbers
| Week of | New stars |
|---|---|
| Aug 9, 2026 | 20 |
| Aug 16, 2026 | 16 |
| Aug 23, 2026 | 16 |
| Aug 30, 2026 | 14 |
| Sep 6, 2026 | 13 |
| Sep 13, 2026 | 14 |
| Sep 20, 2026 | 14 |
| Sep 27, 2026 | 13 |
| Oct 4, 2026 | 16 |
| Oct 11, 2026 | 16 |
| Oct 18, 2026 | 17 |
| Oct 25, 2026 | 11 |
The Board ranks tools by four signals each week: new stars, new stars for the repo's size, added downloads and download growth beyond the market. How the ranking works.
Google Gen AI SDK alternatives
Other LLM SDKs and gateways on the Board in the week of Oct 25–31, 2026, by momentum:
| Rank | Tool | Stars | Downloads/wk |
|---|---|---|---|
| #1 | thinking-orbsthinking-orbs is a React library of dotted, animated thought-orb loading indicators for AI and agent user interfaces. | 3.9k | 1.4M |
| #2 | HeadroomHeadroom compresses tool outputs, logs, files, and RAG chunks locally before they reach the LLM, as a library, proxy, or MCP server. | 78.5k | 125.8k |
| #3 | LiteLLMLiteLLM is an open source AI gateway and Python SDK that calls 100+ LLM providers through one OpenAI-format interface. | 62.5k | 23.1M |
| #4 | Honcho Memory library for building stateful agents | 7.9k | – |
| #5 | Anthropic SDKAnthropic SDK is the official Python library for calling the Claude API from Python applications. | 4k | 111M |
| #6 | Hugging Face HubHugging Face Hub is the official CLI and Python client for downloading, uploading and managing models, datasets and Spaces on the… | 4k | 68.3M |
Recent Google Gen AI SDK releases
Google Gen AI SDK FAQ
Is Google Gen AI SDK free and open source?
Yes. Google Gen AI SDK's source code is on GitHub (googleapis/python-genai) under the Apache 2.0 license, so you can use it for free.
How do I install Google Gen AI SDK?
Run pip install google-genai. It needs Node.js >=20.0.0. The install section above has the other options from the project's README.
Is Google Gen AI SDK still maintained?
Yes. The googleapis/python-genai repository was last updated on Oct 21, 2026, and the latest release, v2.32.0 on GitHub, came out on Oct 21, 2026.
How popular is Google Gen AI SDK?
Google Gen AI SDK has 4k GitHub stars as of Nov 1, 2026. It gained 11 new stars in the week of Oct 25–31, 2026, against a 12-week average of 15 a week. Its main package had about 67.8M downloads that week, +4% against its own 4-week average. That made it #14 among LLM SDKs and gateways on the Devtoolwatch Board.
What are the best alternatives to Google Gen AI SDK?
Other LLM SDKs and gateways on the Devtoolwatch Board in the week of Oct 25–31, 2026, by momentum: thinking-orbs (#1), Headroom (#2), LiteLLM (#3), Honcho (#4), Anthropic SDK (#5). The alternatives table above has their numbers.
What is Google Gen AI SDK?
Google Gen AI SDK is a Python library from Google for integrating Google's generative models into Python applications. It supports the Gemini Developer API and Gemini Enterprise Agent Platform APIs.
Is there a Google Gen AI SDK for JavaScript and TypeScript?
Yes. Google publishes a related npm package, @google/genai, which requires Node.js 20.0.0 or later. This repository covers the Python SDK.
Where is the Google Gen AI SDK documentation?
The Google Gen AI SDK documentation is at https://googleapis.github.io/python-genai/. It includes modules for client, live, models, tokens, tunings and types.
How does Google Gen AI SDK authenticate?
Google Gen AI SDK uses an API key for the Gemini Developer API, passed to the client or read from GEMINI_API_KEY or GOOGLE_API_KEY. For Agent Platform, it uses a project and location. If both key variables are set, GOOGLE_API_KEY takes precedence.
Can Google Gen AI SDK help AI coding assistants write correct code?
Yes. The README recommends loading Gemini API Skills into assistants such as Claude Code or Cursor. The skills come from google-gemini/gemini-skills for the Developer API, or google/skills for Agent Platform.
Does Google Gen AI SDK work behind a proxy?
Yes. Google Gen AI SDK reads proxy settings such as HTTPS_PROXY from environment variables. It supports socks5 through httpx[socks] and accepts a custom base URL for API gateway proxies.
Sources
Google Gen AI SDK README badge
Maintainers can show the tool's weekly Board rank in their README:
[](https://index.devtoolwatch.com/tools/google-genai/)How this page is made: Devtoolwatch writes each review from the project's README, releases, package metadata and website, with an AI model, then checks every claim against the source it cites and drops what the sources don't support. The numbers come from Devtoolwatch's daily GitHub snapshots, GitHub's stargazer history, and the npm and PyPI download APIs. Spotted an error? Email [email protected].