Agent Development Kit

2.6.0 (2026-07-29)

Features

• a2a: support per-invocation auth headers when fetching agent cards (3dd1156)
• add --extra_packages option to adk deploy agent_engine (93db97d), closes #3936
• Add ADK evaluation samples: shared home-automation agent (6ba41ef)
• add agent identity auth manager finalize endpoint for 3 legged OAuth flow with auth manager (8d2ded3)
• Add basic_criteria ADK eval sample (fdebd9d)
• Add bigquery-graph skill to ADK BigQuery tools (f1a0a14)
• add capability to log commands run in CLI (a58220c)
• Add custom_metric ADK eval sample (f71d9df)
• Add llm_judge_match ADK eval sample (0f0fa6b)
• add metadata extraction symmetry to A2A converters (3127f36)
• add opt-in final_response_tool_names to BigQueryAgentAnalyticsPlugin (07455ee)
• Add ReflectAndRetryModelPlugin for self-healing model errors (322f455)
• Add rubric_criteria ADK eval sample (852a66a)
• add state_delta support to LiveRequest for live mode (8219774), closes #4220
• add telemetry consent check, status commands, and interrupt safety to CLI (6bab08f)
• Add telemetry consent configuration endpoints and local writing utility (26f3d45)
• add telemetry metrics collection for ADK CLI execution (2280f1c)
• Add test_file_vs_evalset ADK eval sample (57a34ba)
• Add user_simulation ADK eval sample (481fe21)
• agents: add instruction field to ManagedAgent (720af3d)
• agents: forward ManagedAgent instruction as system_instruction (49fdc26)
• eval: Make live and audio evals reachable via public entrypoints (5091f0a)
• eventarc: add Eventarc Advanced toolset for ADK (217a90a)
• eventarc: add Eventarc Advanced toolset for ADK (d4f157d)
• forward the OAuth2 nonce t

Agent Development Kit (ADK) 2.0

License

PyPI version

Python versions

PyPI downloads

Unit Tests

Docs

<h2 align="center">

<img src="https://raw.githubusercontent.com/google/adk-python/main/assets/agent-development-kit.png" width="256"/>

</h2>

<h3 align="center">

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

</h3>

<h3 align="center">

Important Links:

<a href="https://google.github.io/adk-docs/">Docs</a>,

<a href="https://github.com/google/adk-samples">Samples</a> &

<a href="https://github.com/google/adk-web">ADK Web</a>.

</h3>

---

⚠️ BREAKING CHANGES FROM 1.x

This release includes breaking changes to the agent API, event model, and

session schema. **Sessions generated by ADK 2.0 are readable by ADK 1.28+

(extra fields will be ignored), but are incompatible with older 1.x versions.**

---

🔥 What's New in 2.0

• Workflow Runtime: A graph-based execution engine for composing

deterministic execution flows for agentic apps, with support for routing,

fan-out/fan-in, loops, retry, state management, dynamic nodes,

human-in-the-loop, and nested workflows.

• Task API: Structured agent-to-agent delegation with multi-turn task

mode, single-turn controlled output, mixed delegation patterns,

human-in-the-loop, and task agents as workflow nodes.

🚀 Installation

pip install google-adk

Requirements: Python 3.10+.

For transitive dependency protection, we recommend to install with our companion

constraints files (for python 3.10 to 3.14).

Choose the constraints file matching your Python version:

# For example, for Python 3.10
curl -o constraints-3.10.txt https://github.com/google/adk-python/blob/main/constraints-3.10.txt
pip install google-adk -c constraints-3.10.txt
rm constraints-3.10.txt

To install optional integrations, you can use the following command:

pip install "google-adk[extensions]"

The release cadence is roughly bi-weekly.

Quick Start

Beginner Note: ADK applications are built using two main classes:

Agent (defines an AI's instructions, tools, and behavior) and

Workflow (orchestrates agents and tasks in a graph-based flow).

Agent

from google.adk import Agent

root_agent = Agent(
    name="greeting_agent",
    model="gemini-2.5-flash",
    instruction="You are a helpful assistant. Greet the user warmly.",
)

Workflow

from google.adk import Agent, Workflow

generate_fruit_agent = Agent(
    name="generate_fruit_agent",
    instruction="Return the name of a random fruit. Return only the name.",
)

generate_benefit_agent = Agent(
    name="generate_benefit_agent",
    instruction="Tell me a health benefit about the specified fruit.",
)

root_agent = Workflow(
    name="root_agent",
    edges=[("START", generate_fruit_agent, generate_benefit_agent)],
)

Run Locally

# Interactive CLI
adk run path/to/my_agent

# Web UI (supports multi-agent directories or pointing directly to a single agent folder)
adk web path/to/agents_dir

📚 Documentation

• Getting Started: https://google.github.io/adk-docs/
• Samples: See contributing/workflow_samples/ and

contributing/task_samples/ for workflow and task API examples.

🤝 Contributing

See CONTRIBUTING.md for details.

📄 License

This project is licensed under the Apache 2.0 License — see the

LICENSE file for details.