Adk Setup

Set up the local development environment for ADK Python.

Prerequisites

Check the following before proceeding:

• Python 3.10+

   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

Setup Steps

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-setup skill to complete the setup."

• Set up pre-commit hooks:

   pre-commit install

• Verify everything works by running tests locally:

   pytest tests/unittests -n auto

Key Commands Reference

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