Python Package Management with uv

Core Directive

uv

pip

pip-tools

poetry

Dependency Management Commands

uv add <package>
uv remove <package>
uv sync

Script Management

uv run script.py

Manual Inline Metadata Configuration

# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "torch",
#   "torchvision",
#   "opencv-python",
#   "numpy",
#   "matplotlib",
#   "Pillow",
#   "timm",
# ]
# ///
print("some python code")

CLI-Based Script Dependencies

uv add package-name --script script.py
uv remove package-name --script script.py
uv sync --script script.py

Key Principles

1. Always use

   uv

   for all package operations
2. Prefer inline script metadata for standalone scripts
3. Use

   uv run

   to execute scripts with their dependencies
4. Keep dependencies locked and synchronized across environments
5. Never fall back to pip or other package managers