Google ADK — Official AI Agent Dev Kit
Google's open-source Agent Development Kit for building, evaluating, and deploying AI agents in Python. 18.7K+ stars. Multi-agent, tool use, eval. Apache 2.0.
What it is
Google ADK (Agent Development Kit) is Google's official open-source Python toolkit for building AI agents. It provides a code-first framework for defining agents with tool use, multi-agent orchestration, evaluation, and deployment capabilities. ADK supports Gemini models natively and integrates with the Google AI ecosystem.
ADK targets Python developers building AI agents who want an officially supported framework from Google. It handles agent definition, tool binding, conversation management, multi-agent delegation, and evaluation in a unified API.
How it saves time or tokens
ADK provides the scaffolding for agent development that you would otherwise build yourself: tool registration, conversation state management, multi-agent routing, and evaluation harnesses. The CLI (adk create, adk run, adk eval) accelerates the development loop. Built-in evaluation tools let you test agent behavior systematically before deployment.
How to use
- Install ADK:
pip install google-adk. - Create an agent project:
adk create my_agent. - Define your agent, add tools, and run it:
adk run my_agent.
Example
from google.adk import Agent, Tool
# Define a tool
@Tool
def search_docs(query: str) -> str:
'''Search documentation for relevant information.'''
# Your search implementation
return f'Results for: {query}'
# Create an agent
agent = Agent(
name='doc_assistant',
model='gemini-2.0-flash',
tools=[search_docs],
instruction='You are a documentation assistant. Use search_docs to find answers.'
)
# Run via CLI
# adk run doc_assistant
# CLI workflow
pip install google-adk
adk create my_agent
adk run my_agent
adk eval my_agent --test-file tests.json
Related on TokRepo
- Agent Tools — AI agent frameworks and orchestration
- Coding AI Tools — Developer tools for AI applications
Common pitfalls
- ADK is optimized for Gemini models. While other models may work through adapters, Gemini gets the best support for tool calling and multi-turn conversations.
- Multi-agent orchestration adds complexity. Start with a single agent and add delegation only when a single agent cannot handle the task scope.
- Evaluation test files require structured input/output pairs. Invest in creating good test cases early to catch agent regressions.
Frequently Asked Questions
ADK is designed for Gemini models (gemini-2.0-flash, gemini-2.0-pro, etc.) through the Google AI API or Vertex AI. It may support other models through adapter layers, but Gemini gets first-class support.
ADK supports multi-agent orchestration where a supervisor agent delegates tasks to specialized sub-agents. Each agent has its own tools and instructions. The supervisor routes requests based on the task type.
Yes. ADK agents can be deployed as APIs using standard Python web frameworks. Google also provides deployment options through Vertex AI for managed hosting with auto-scaling.
ADK includes an evaluation framework where you define test cases (input, expected output) in JSON files. Run adk eval to test your agent against these cases and get pass/fail results with detailed comparison.
Yes. ADK is open-source under the Apache 2.0 license. You pay only for the LLM API calls (Gemini API or Vertex AI). The framework itself is free.
Citations (3)
- Google ADK GitHub— Google ADK is the official Python toolkit for building AI agents
- Google AI Documentation— Gemini model integration and tool use
- Google Developers— AI agent development frameworks and patterns
Related on TokRepo
Discussion
Related Assets
NAPI-RS — Build Node.js Native Addons in Rust
Write high-performance Node.js native modules in Rust with automatic TypeScript type generation and cross-platform prebuilt binaries.
Mamba — Fast Cross-Platform Package Manager
A drop-in conda replacement written in C++ that resolves environments in seconds instead of minutes.
Plasmo — The Browser Extension Framework
Build, test, and publish browser extensions for Chrome, Firefox, and Edge using React or Vue with hot-reload and automatic manifest generation.