---
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.