Contributing

Python environment

Use uv to manage the virtual environment and dependencies:

uv venv .venv
source .venv/bin/activate
uv pip install -e ".[dev]"

Code style

• ruff check src tests
• ruff format src tests
• mypy src

Tests

pytest

Adding a camera channel

1. Update config/local.json with the new channel.
2. Place the channel-specific YOLO weights under data/models/.
3. Add a unit test under tests/unit/.