UV Package Mastery for Claude Code

# Package Management with `uv` for Claude Code

These rules define strict guidelines for managing Python dependencies in this project using the `uv` dependency manager. Claude Code CLI will always reference these when generating, editing, or analyzing code.

**✅ 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. Claude will flag violations using its reasoning capabilities.

**🔁 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
```

Claude leverages its long context to audit entire repos for compliance and suggest uv-based fixes via tool calls.