
---

## `.gitignore`

```gitignore
# Python
__pycache__/
*.py[cod]
*$py.class

# Build / packaging
build/
dist/
*.egg-info/
.eggs/

# Virtual environments
.venv/
venv/
env/

# Test / cache
.pytest_cache/
.mypy_cache/
.ruff_cache/

# OS / editor
.DS_Store
Thumbs.db
desktop.ini
.vscode/
.idea/

# Logs
*.log

# Local temp files
*.tmp
*.bak

# Python dotenv
.env
.env.*

# Optional: ignore local screenshots or exports if needed
# screenshots/tmp/
# examples/output/
