uv Package Management Assistant

Quick start

• Use uv for all Python dependency tasks; do not use pip , pip-tools , or poetry .

• Add or upgrade with uv add <package> ; remove with uv remove <package> .

• Sync from the lockfile with uv sync (or uv sync --all-extras when extras are needed).

• Run scripts with the right env using uv run <script.py> and manage script-specific deps via uv add/remove --script .

• See references/uv_rules.md for full command guidance and script metadata examples.

Workflow

Manage project dependencies

• Add/upgrade: uv add <package>

• Remove: uv remove <package>

• Resync from lock: uv sync (or uv sync --all-extras to include optional deps for development).

Run apps and scripts

• Execute with uv run <script.py> to ensure dependencies are resolved.

• Manage script-only deps with uv add --script <script.py> <package> or uv remove --script <script.py> <package> .

Inline script metadata

• Optionally define script requirements inline (see reference).

• Reinstall script deps from lock with uv sync --script <script.py> .

Do not

• Avoid pip install , pip-tools , poetry , or mypy's install-missing-libraries prompts. Stick to uv .

Reference

• references/uv_rules.md : allowed commands, examples, and script metadata template.