Development

Install all dependency groups before running checks:

pdm install -G:all

The Makefile wraps the standard validation path:

make lint
make type
make test
make docs

The equivalent PDM commands are:

pdm run ruff check .
pdm run mypy src
pdm run pytest
pdm run sphinx-build -b html docs/source docs/source/_build/html

Live Tavily tests are opt-in:

cp .env.example .env
# set TAVILY_API_KEY in .env
make test-live