// Set up a local development environment for the ADK Python project. Use when the user wants to get started developing, set up their environment, install dependencies, or prepare for contributing.
Central hub for building, testing, and iterating on ADK agents. Trigger this skill when the user wants to create a new agent, configure modes (task, single-turn), or build graph-based workflows.
ADK architectural knowledge — graph orchestration, resumption, execution flow, node contracts, observability, and LLM context orchestration. Use this skill whenever you need to understand the architecture, event flow, or state management of the ADK system, or when designing or modifying core components. Triggers on "how does X work", "design of", "architecture of", "event flow", "resumption state", "checkpoint", "BaseNode", "NodeRunner".
Use when debugging ADK agents, inspecting sessions, testing agent behavior, troubleshooting tool calls, event flow issues, or diagnosing LLM/model problems.
Use for any git operation (commit, push, pull, rebase, branch, PR, cherry-pick, etc.). Provides commit message format and conventions.
Author new samples for the ADK Python repository. Use this skill when the user wants to create a new sample demonstrating a feature or agent pattern (e.g., dynamic nodes, standalone agents, fan-out/fan-in) or when adding examples to subdirectories under `contributing/`.
ADK development style guide for routine nits — Python idioms, codebase conventions, imports, typing, Pydantic patterns, formatting, logging, and file organization. Use this skill whenever writing code, tests, or reviewing PRs for the ADK project to ensure compliance with styling and coding conventions. Triggers on "code style", "how should I format", "naming convention", "lint", "nit", "imports", "typing", "Pydantic patterns", "testing rules".
| name | adk-setup |
| description | Set up a local development environment for the ADK Python project. Use when the user wants to get started developing, set up their environment, install dependencies, or prepare for contributing. |
| disable-model-invocation | true |
Set up the local development environment for ADK Python.
Check the following before proceeding:
Python 3.11+
python3 --version
uv package manager (required — do not use pip/venv directly)
uv --version
If not installed:
curl -LsSf https://astral.sh/uv/install.sh | sh
Run these commands from the project root:
Create and activate a virtual environment:
uv venv --python "python3.11" ".venv"
source .venv/bin/activate
Install all dependencies for development:
uv sync --all-extras
Install development tools:
uv tool install pre-commit
uv tool install tox --with tox-uv
Install addlicense (requires Go):
go version && go install github.com/google/addlicense@latest
[!NOTE] If Go is not installed, tell the user: "Go is required for the addlicense tool. Please install Go from https://go.dev/dl/ and then re-run the
adk-setupskill to complete the setup."
Set up pre-commit hooks:
pre-commit install
Verify everything works by running tests locally:
pytest tests/unittests -n auto
| Task | Command |
|---|---|
| Run unit tests (Fast) | pytest tests/unittests |
| Run tests across all Python versions | tox |
| Format codebase | pre-commit run --all-files |
| Run tests in parallel | pytest tests/unittests -n auto |
| Run specific test file | pytest tests/unittests/agents/test_llm_agent.py |
| Launch web UI | adk web path/to/agents_dir |
| Run agent via CLI | adk run path/to/my_agent |
| Build wheel | uv build |