NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #212 most downloaded on PyPI
GenAI Python SDK
Last release 2 days ago
02 Oct 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
2 years old
128 releases · first in 2024
One column per month.
Add lyria-3.5 , gemini-omni-1.1-flash , and gemini-omni-flash-preview to Interactions Model enum
Add gcs_metrics_uri for exporting tuning job metrics.
--usage schema (2579b94)CreateAgentInteraction for Trigger.interaction and TriggerCreateParams.interaction (046ccfb)Add sample_audio to Voice in GAOS SDK
Add credential APIs resource to gaos.
Add from_environment support for environment copying
Add Gemini 3.8 Flash model to SDKs and update Flash model descriptions
Add destination parameter to client.files.download to support streaming downloads to disk or file-like objects
Add AudioTranscriptionConfigMode
Add IDLE state to live connection status enum and mark REQUIRES_ACTION as deprecated.
mode enum (VERBATIM, SMART) to AudioTranscriptionConfig and TranscriptionConfig. (e8cd7d0)2.18.1 (2026-08-13) Bug Fixes Add gemini-3.7-flash
Add interaction_status to LiveServerContent
Add the Gemini Robotics ER 2 Preview model
Support GoogleMaps Tool grounding_types places and routing
[GenerateContentConfig] Add GenerationConfig.audio_transcription_config and Part.audio_transcription.
language_codes field to AudioTranscriptionConfig. (fc282b3)Add deprecation warnings to Imagen generate_images, edit_images, generate_videos (if using prompt/text/image args), LiveConnectConfig.GenerationConfig…
A new field custom_vocabulary is added to to Live API
custom_vocabulary is added to to Live API (4eeb1ad)custom_vocabulary is added to message .google.cloud.aiplatform.v1beta1.BidiGenerateContentSetup (4eeb1ad)Fix the normalization of Interactions inside triggers
Add AntigravityAgentConfig to OpenAPI schema overlays and regenerate SDKs.
Add environment_id in network config
Add Agent Platform MCP support to async generate_content_stream
Use .model_copy() instead of deprecated .copy()
aiohttp.readline without max_line_length for backward compatibility because we still want to keep aiohttp as optional dependency (e99ab99), closes #2487transformers an optional dependency for local tokenizers, also add other dependencies to local-tokenizer-extras. (528926b)Add audioOffset to VoiceActivity
Announce Automatic Function Calling (AFC) upcoming breaking change warning
aiohttp.readline without max_line_length for backward compatibility because we still want to keep aiohttp as optional dependency (e99ab99), closes #2487transformers an optional dependency for local tokenizers, also add other dependencies to local-tokenizer-extras. (528926b)Add Agent Platform MCP support to async generate_content
enable_widget in message GoogleMaps is changed (74d81dd)google_maps_widget_context_token in message GroundingMetadata is changed (74d81dd)codegen_instructions.md for simpler maintenance, Gemini API Skills should be the single source of truth (bfa2a49)Additional computer_use field support for vertex.
Add enable_prompt_injection_detection for Computer Use feature for the Gemini API.
Add Gemini 3.5 Flash model to options
Support Agent and Environment APIs.
Add content union to UserInputStep
Added missing FunctionCallResultDelta type and arguments field to the ArgumentDelta type
Add gemini-3.1-flash-lite to model options
Update response_format field names to snake_case.
Note: The breaking changes are only in interactions. GenerateContent usage in unaffected. Refer to https://ai.google.dev/gemini-api/docs/interactions-…
Note: The breaking changes are only in interactions. GenerateContent usage in unaffected.
Refer to https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026 for details
[Python] Multimodal file search
[Interactions] Add FileCitation.{custom_metadata,media_id,page_number}
output_info to BatchJob (7b77ab8)enterprise to Client constructor and GOOGLE_GENAI_USE_ENTERPRISE (693fd9a)AsyncClient.__aexit__, __exit__. (a74dc65)Vertex AI with Gemini Enterprise Agent Platform, update method error message to replace Vertex AI with Gemini Enterprise Agent Platform (previously known as Vertex AI), update converter error message to replace Vertex AI with Gemini Enterprise Agent Platform (413f0f9)Refactor Webhook types in GenAI SDKs for easier useage
> CRITICAL WARNING: Do not use this version if you are implementing or relying on webhooks. This release contains known issues regarding webhook sdk.
[!CAUTION] CRITICAL WARNING: Do not use this version if you are implementing or relying on webhooks. This release contains known issues regarding webhook sdk. Please use v1.74.0 or later.
Add "eu" as a supported service location for Vertex AI platform.
Remove deprecated product recontext model samples from docstrings
Support dedicated TextAnnotationDelta for streaming tool responses
Add consent_audio and voice_consent_signature and AsyncSession.setup_complete
[Interactions] Breaking change to Interactions API to refactor TextContent annotations to use specific citation types
attempts=0 as attempts=1 in retry options to ensure no retries (2856c0a)> This release contains a bug where the typing-extensions lower bound is set too low, which causes the SDK to break in some environments.
[!CAUTION] Known Issue: This release contains a bug where the
typing-extensionslower bound is set too low, which causes the SDK to break in some environments.Recommended Actions:
- Fall back to 1.66.0: If you do not immediately need the new features in 1.67.0, we recommend sticking with the previous stable version:
pip install google-genai==1.66.0- Manual Fix: If you must use 1.67.0, you can resolve the issue by manually upgrading
typing-extensions:pip install "typing-extensions>=4.14.0"
Add gemini-3.1-flash-image-preview model
Change interactions media mime type to enum (breaking change for experimental feature)
Add UnifiedMetric support to Vertex Tuning evaluation config
Add INCOMPLETE status to Interaction.
websockets (3b82b5f)Add error handling for live and live music APIs (1148276), closes #668
Add include_input query parameter to Get Interaction endpoint.
include_input query parameter to Get Interaction endpoint. (a0240d9)Add ModelArmorConfig support for prompt and response sanitization via the Model Armor service
Set the environment variable GOOGLE_API_PREVENT_AGENT_TOKEN_SHARING_FOR_GCP_SERVICES to 'false' within BaseApiClient to disable bound token sharing.
Add FileSearchCallContent to Interactions
[Python] add RegisterFiles so gcs files can be used with genai.
Add minimal and medium thinking levels.
Add the Interactions API (836a3)
Apply timeout to the total request duration in aiohttp
Add empty response for tunings.cancel()
Add support for configuring resource scope when using base_url
Add a pre-validation hook to warn about Pydantic model type mismatches.
Your coding agent can read these notes before it upgrades. Set up the MCP server →