# adk-python

> An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.

- **URL**: https://www.freshcrate.ai/projects/adk-python
- **Author**: google
- **Category**: AI Agents
- **Latest version**: `v2.2.0` (2026-06-04)
- **License**: Apache-2.0
- **Source**: https://github.com/google/adk-python
- **Homepage**: https://google.github.io/adk-docs/
- **Language**: Python
- **GitHub**: 19,165 stars, 3,281 forks
- **Registry**: github
- **Tags**: `agent`, `agentic`, `agentic-ai`, `agents`, `agents-sdk`, `ai`, `ai-agents`, `aiagentframework`, `python`

## Description

An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.2.0` | 2026-06-04 | High | ## [2.2.0](https://github.com/google/adk-python/compare/v2.1.0...v2.2.0) (2026-06-04)   ### ⚠ BREAKING CHANGES  * **agents:** `LlmAgent` default model changed from `gemini-2.5-flash` to `gemini-3-flash-preview` (a preview model), ahead of the 2026-10-16 `gemini-2.5-flash` shutdown. Agents without an explicit `model=` now run on the new preview default; set `model="gemini-2.5-flash"` to retain prior behavior. `DEFAULT_LIVE_MODEL` is unchanged. ([ad8b6c7](https://github.com/google/adk-pyt |
| `v1.34.1` | 2026-05-23 | High | ## [1.34.1](https://github.com/google/adk-python/compare/v1.34.0...v1.34.1) (2026-05-22)   ### Bug Fixes  * Fix bug where grounding metadata in Gemini 3.1 live was being silently discarded ([9b6b9e9](https://github.com/google/adk-python/commit/9b6b9e976300ab223c77075554d6cd66ce1179ff)) * fix input and output transcription finished events for Gemini v3.1 ([13763d7](https://github.com/google/adk-python/commit/13763d71f883b215dae08feb3f042869b9cd5d18)) * **tools:** Prevent session drop on MCP tool |
| `v2.1.0` | 2026-05-23 | Medium | ## [2.1.0](https://github.com/google/adk-python/compare/v2.0.0...v2.1.0) (2026-05-23)   ### Features  * Add chart generation and artifact loading to data agent ([db06416](https://github.com/google/adk-python/commit/db064160bf634b1c7e644012076f077cde6cfcef)) * Add support for creating sandboxes from templates and snapshots ([cbd14eb](https://github.com/google/adk-python/commit/cbd14ebf99bbff22ed28273f095f1fc05793bed2)) * Add user.id to gen_ai.user.message log records for telemetry ([eb379b |
| `v2.1.0` | 2026-05-23 | Medium | ## [2.1.0](https://github.com/google/adk-python/compare/v2.0.0...v2.1.0) (2026-05-23)   ### Features  * Add chart generation and artifact loading to data agent ([db06416](https://github.com/google/adk-python/commit/db064160bf634b1c7e644012076f077cde6cfcef)) * Add support for creating sandboxes from templates and snapshots ([cbd14eb](https://github.com/google/adk-python/commit/cbd14ebf99bbff22ed28273f095f1fc05793bed2)) * Add user.id to gen_ai.user.message log records for telemetry ([eb379b |
| `v2.1.0` | 2026-05-23 | Medium | ## [2.1.0](https://github.com/google/adk-python/compare/v2.0.0...v2.1.0) (2026-05-23)   ### Features  * Add chart generation and artifact loading to data agent ([db06416](https://github.com/google/adk-python/commit/db064160bf634b1c7e644012076f077cde6cfcef)) * Add support for creating sandboxes from templates and snapshots ([cbd14eb](https://github.com/google/adk-python/commit/cbd14ebf99bbff22ed28273f095f1fc05793bed2)) * Add user.id to gen_ai.user.message log records for telemetry ([eb379b |
| `v2.1.0` | 2026-05-23 | Medium | ## [2.1.0](https://github.com/google/adk-python/compare/v2.0.0...v2.1.0) (2026-05-23)   ### Features  * Add chart generation and artifact loading to data agent ([db06416](https://github.com/google/adk-python/commit/db064160bf634b1c7e644012076f077cde6cfcef)) * Add support for creating sandboxes from templates and snapshots ([cbd14eb](https://github.com/google/adk-python/commit/cbd14ebf99bbff22ed28273f095f1fc05793bed2)) * Add user.id to gen_ai.user.message log records for telemetry ([eb379b |
| `v2.1.0` | 2026-05-23 | Medium | ## [2.1.0](https://github.com/google/adk-python/compare/v2.0.0...v2.1.0) (2026-05-23)   ### Features  * Add chart generation and artifact loading to data agent ([db06416](https://github.com/google/adk-python/commit/db064160bf634b1c7e644012076f077cde6cfcef)) * Add support for creating sandboxes from templates and snapshots ([cbd14eb](https://github.com/google/adk-python/commit/cbd14ebf99bbff22ed28273f095f1fc05793bed2)) * Add user.id to gen_ai.user.message log records for telemetry ([eb379b |
| `v2.1.0` | 2026-05-23 | Medium | ## [2.1.0](https://github.com/google/adk-python/compare/v2.0.0...v2.1.0) (2026-05-23)   ### Features  * Add chart generation and artifact loading to data agent ([db06416](https://github.com/google/adk-python/commit/db064160bf634b1c7e644012076f077cde6cfcef)) * Add support for creating sandboxes from templates and snapshots ([cbd14eb](https://github.com/google/adk-python/commit/cbd14ebf99bbff22ed28273f095f1fc05793bed2)) * Add user.id to gen_ai.user.message log records for telemetry ([eb379b |
| `v1.34.0` | 2026-05-18 | High | ## [1.34.0](https://github.com/google/adk-python/compare/v1.33.0...v1.34.0) (2026-05-18)   ### Features  * **a2a:** add support for persistent task stores ([cd78d87](https://github.com/google/adk-python/commit/cd78d87b967111d40d429bcf9552a962b7e9614f)) * add general support for Gemini Live API in ADK evaluate ([790c9be](https://github.com/google/adk-python/commit/790c9bef9a336ea000d0cf68e63b025dfead5227)) * Add mTLS support to Google Cloud Telemetry exporter ([cfe8d2c](https://github.com/google/ |
| `v1.33.0` | 2026-05-08 | High | ## [1.33.0](https://github.com/google/adk-python/compare/v1.32.0...v1.33.0) (2026-05-08)   ### Features  * add BufferableSessionService ([0bc767e](https://github.com/google/adk-python/commit/0bc767e6892742d6290d3445d028f95925187aed)) * **apigee:** allow injecting credentials into ApigeeLlm ([ce578ff](https://github.com/google/adk-python/commit/ce578fffa0dc02b0033f7f5e705b9422cbd6c252)) * Make ADK environment tools truncation limit configurable ([83ae405](https://github.com/google/adk-pyth |

## Dependency audit

- **Score**: 77/100
- **Total deps**: 6
- **Resolved**: 2
- **Unresolved**: 4
- **License conflicts**: 0
- **Warnings**: 5
- **Scanned**: 2026-05-11

## Citation

- HTML: https://www.freshcrate.ai/projects/adk-python
- Markdown: https://www.freshcrate.ai/projects/adk-python.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/adk-python/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._