Development
Setup
# Install dependencies
uv sync
# Install pre-commit hooks
uv run pre-commit install
# Copy environment file
cp .env.example .env
Running Tests
uv run pytest
Linting & Formatting
uv run ruff check --fix
uv run ruff format
Type Stubs (Optional)
For better IDE autocomplete with bpy, install type stubs into a separate virtual environment:
uv venv .stubs-venv
uv pip install --python .stubs-venv/Scripts/python.exe -e ".[stubs]"
Warning
Do not install stubs into the main .venv—they conflict with the real bpy package.