# Package Management with `uv`
These rules define strict guidelines for managing Python dependencies in this project using the `uv` dependency manager.
**✅ Use `uv` exclusively**
- All Python dependencies **must be installed, synchronized, and locked** using `uv`.
- Never use `pip`, `pip-tools`, or `poetry` directly for dependency management.
**🔁 Managing Dependencies**
Always use these commands:
```bash
# Add or upgrade dependencies
uv add <package>
# Remove dependencies
uv remove <package>
# Reinstall all dependencies from lock file
uv sync
```
**🔁 Scripts**
```bash
# Run script with proper dependencies
uv run script.py
```
You can edit inline-metadata manually:
```python
# /// script
# requires-python = ">=3.12"
# dependencies = [
# "torch",
# "torchvision",
# "opencv-python",
# "numpy",
# "matplotlib",
# "Pillow",
# "timm",
# ]
# ///
print("some python code")
```
Or using uv cli:
```bash
# Add or upgrade script dependencies
uv add package-name --script script.py
# Remove script dependencies
uv remove package-name --script script.py
# Reinstall all script dependencies from lock file
uv sync --script script.py
```