Google ADK

Build agents using Google's Agent Development Kit with Gemini models.

Language:PythonProvider:GoogleKey required:GOOGLE_API_KEY

Quick start

1

Create the project

npx agentvoy create my-project --framework google-adk --provider google --model gemini-2.0-flash --yes
2

Install and configure

cd my-project-agent
pip install -r requirements.txt
cp .env.example .env
# Add: GOOGLE_API_KEY=AIza...
3

Run with ADK CLI

# Interactive terminal
adk run my_project_agent

# Or use the ADK web UI
adk web my_project_agent

Project structure

Google ADK uses a package-based structure (different from other frameworks):

my-project-agent/
my_project_agent/
__init__.py
agent.py # root_agent definition
tools.py
agent.guard.yml
requirements.txt

Multi-agent mode

Google ADK handles multi-agent natively using sub-agents. AgentVoy generates the ADK sub-agent structure instead of a pipeline.py:

npx agentvoy create my-project --framework google-adk --build-mode app --agent-mode multi --yes

Compatible providers

Google ADK works best with Google (Gemini) as the provider. Using other providers may require additional configuration. Get your key: Google API key guide.