adk-setup · AI/ML · Mesrai Skills

Set up the local development environment for ADK Python.

Prerequisites

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

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`