---
name: uv-package-management-assistant
description: python's package managing
alwaysApply: false
---
# 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
1) **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).
2) **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>`.
3) **Inline script metadata**
- Optionally define script requirements inline (see reference).
- Reinstall script deps from lock with `uv sync --script <script.py>`.
4) **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.
