# google-adk > Agent Development Kit - **URL**: https://www.freshcrate.ai/projects/google-adk - **Author**: pypi - **Category**: Frameworks - **Latest version**: `v2.2.0` (2026-06-04) - **License**: Unknown - **Source**: https://github.com/google/adk-python/blob/main/CHANGELOG.md - **Homepage**: https://pypi.org/project/google-adk/ - **Language**: Python - **GitHub**: 19,165 stars, 3,281 forks - **Registry**: pypi (`google-adk`) - **Tags**: `pypi` ## Description # Agent Development Kit (ADK) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE) [![PyPI](https://img.shields.io/pypi/v/google-adk)](https://pypi.org/project/google-adk/) [![Python Unit Tests](https://github.com/google/adk-python/actions/workflows/python-unit-tests.yml/badge.svg)](https://github.com/google/adk-python/actions/workflows/python-unit-tests.yml) [![r/agentdevelopmentkit](https://img.shields.io/badge/Reddit-r%2Fagentdevelopmentkit-FF4500?style=flat&logo=reddit&logoColor=white)](https://www.reddit.com/r/agentdevelopmentkit/) Ask Code Wiki

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

Important Links: Docs, Samples, Java ADK, Go ADK & ADK Web.

Agent Development Kit (ADK) is a flexible and modular framework that applies software development principles to AI agent creation. It is designed to simplify building, deploying, and orchestrating agent workflows, from simple tasks to complex systems. While optimized for Gemini, ADK is model-agnostic, deployment-agnostic, and compatible with other frameworks. --- ## 🔥 What's new - **Custom Service Registration**: Add a service registry to provide a generic way to register custom service implementations to be used in FastAPI server. See [short instruction](https://github.com/google/adk-python/discussions/3175#discussioncomment-14745120). ([391628f](https://github.com/google/adk-python/commit/391628fcdc7b950c6835f64ae3ccab197163c990)) - **Rewind**: Add the ability to rewind a session to before a previous invocation ([9dce06f](https://github.com/google/adk-python/commit/9dce06f9b00259ec42241df4f6638955e783a9d1)). - **New CodeExecutor**: Introduces a new AgentEngineSandboxCodeExecutor class that supports executing agent-generated code using the Vertex AI Code Execution Sandbox API ([ee39a89](https://github.com/google/adk-python/commit/ee39a891106316b790621795b5cc529e89815a98)) ## ✨ Key Features - **Rich Tool Ecosystem**: Utilize pre-built tools, custom functions, OpenAPI specs, MCP tools or integrate existing tools to give agents diverse capabilities, all for tight integration with the Google ecosystem. - **Code-First Development**: Define agent logic, tools, and orchestration directly in Python for ultimate flexibility, testability, and versioning. - **Agent Config**: Build agents without code. Check out the [Agent Config](https://google.github.io/adk-docs/agents/config/) feature. - **Tool Confirmation**: A [tool confirmation flow(HITL)](https://google.github.io/adk-docs/tools/confirmation/) that can guard tool execution with explicit confirmation and custom input. - **Modular Multi-Agent Systems**: Design scalable applications by composing multiple specialized agents into flexible hierarchies. - **Deploy Anywhere**: Easily containerize and deploy agents on Cloud Run or scale seamlessly with Vertex AI Agent Engine. ## 🚀 Installation ### Stable Release (Recommended) You can install the latest stable version of ADK using `pip`: ```bash pip install google-adk ``` The release cadence is roughly bi-weekly. This version is recommended for most users as it represents the most recent official release. ### Development Version Bug fixes and new features are merged into the main branch on GitHub first. If you need access to changes that haven't been included in an official PyPI release yet, you can install directly from the main branch: ```bash pip install git+https://github.com/google/adk-python.git@main ``` Note: The development version is built directly from the latest code commits. While it includes the newest fixes and features, it may also contain experimental changes or bugs not present in the stable release. Use it primarily for testing upcoming changes or accessing critical fixes before they are officially released. ## 🤖 Agent2Agent (A2A) Protocol and ADK Integration For remote agent-to-agent communication, ADK integrates with the [A2A protocol](https://github.com/google-a2a/A2A/). See this [example](https://github.com/a2aproject/a2a-samples/tree/main/samples/python/agents) for how they can work together. ## 📚 Documentation Explore the full documentation for detailed guides on building, evaluating, and deploying agents: * **[Do ## 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 | ## Citation - HTML: https://www.freshcrate.ai/projects/google-adk - Markdown: https://www.freshcrate.ai/projects/google-adk.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/google-adk/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._