Intended Audience
- Developers
- Science/Research
License
- OSI Approved :: Apache Software License
Operating System
- OS Independent
Programming Language
- Python
- Python :: 3 :: Only
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
Topic
- Software Development :: Libraries :: Python Modules
Typing
- Typed
Agent Development Kit (ADK) 2.0
An open-source, code-first Python framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
Important Links: Docs, Samples & ADK Web.
โ ๏ธ 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.11+.
To install optional integrations, you can use the following command:
pip install "google-adk[extensions]"
The release cadence is roughly bi-weekly.
Quick Start
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
adk web path/to/agents_dir
๐ Documentation
- Getting Started: https://google.github.io/adk-docs/
- Samples: See
contributing/workflow_samples/andcontributing/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.
Wheel compatibility matrix
Files in release
aiosqlite
(>=0.21)
authlib
(<2,>=1.6.6)
click
(<9,>=8.1.8)
fastapi
(<1,>=0.124.1)
google-auth[pyopenssl]
(>=2.47)
google-genai
(<2,>=1.72)
graphviz
(<1,>=0.20.2)
httpx
(<1,>=0.27)
jsonschema
(<5,>=4.23)
opentelemetry-api
(<=1.41.1,>=1.36)
opentelemetry-sdk
(<=1.41.1,>=1.36)
packaging
(>=21)
pydantic
(<3,>=2.12)
python-dotenv
(<2,>=1)
pyyaml
(<7,>=6.0.2)
requests
(<3,>=2.32.4)
starlette
(<1,>=0.49.1)
tenacity
(<10,>=9)
typing-extensions
(<5,>=4.5)
tzlocal
(<6,>=5.3)
uvicorn
(<1,>=0.34)
watchdog
(<7,>=6)
websockets
(<16,>=15.0.1)