Meta

• License: Apache Software License
• Author: Google LLC
• Requires: Python >=3.10
• Provides-Extra: a2a , agent-identity , all , antigravity , community , db , dev , docs , e2b , eval , extensions , gcp , mcp , otel-gcp , slack , test , toolbox , tools

Classifiers

• 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
  • Python :: 3.14
• Topic
  • Software Development :: Libraries :: Python Modules
• Typing
  • Typed

Agent Development Kit (ADK) 2.0

👁 License
👁 PyPI version
👁 Python versions
👁 PyPI downloads
👁 Unit Tests
👁 Docs

👁 Image

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

pipinstallgoogle-adk

Requirements: Python 3.10+.

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

pipinstall"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

fromgoogle.adkimport Agent

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

Workflow

fromgoogle.adkimport 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
adkrunpath/to/my_agent

# Web UI (supports multi-agent directories or pointing directly to a single agent folder)
adkwebpath/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.

Verified details

These details have been verified by PyPI

Maintainers

👁 Avatar for vertex_ai from gravatar.com
vertex_ai

Unverified details

These details have not been verified by PyPI

Project links

• changelog
• documentation
• homepage
• repository

• Download URL: google_adk-2.3.0.tar.gz
• Upload date: Jun 18, 2026
• Size: 3.4 MB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Hashes for google_adk-2.3.0.tar.gz

Algorithm	Hash digest
SHA256	4b95c99865a9a6b56e8abd3d3b816935f0db1cebbef328736a269b6537bd1df7
MD5	d948e9ca66f188e4081c7baf0a34ddb9
BLAKE2b-256	0bcdb17f7a7574870642be5af42bad831b3800e51529ed2dcdc10493a0a0db23

See more details on using hashes here.

• Download URL: google_adk-2.3.0-py3-none-any.whl
• Upload date: Jun 18, 2026
• Size: 4.0 MB
• Tags: Python 3
• Uploaded using Trusted Publishing? No
• Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Hashes for google_adk-2.3.0-py3-none-any.whl

Algorithm	Hash digest
SHA256	961a08ce50bdc99aaf57e487bae4cc48ed9ee361f15e93562342d4bc3b75739b
MD5	41231d307516ae281083779a038b69ad
BLAKE2b-256	5afe58024a25902d4c6401388515205990d2706901d23634c97f1c8710934fb4

See more details on using hashes here.