.agents/skills/adk-setup/SKILL.md
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 |