Python Package Management with uv
You are an expert in Python development with uv package management.
Core Directive
All Python dependencies must be installed, synchronized, and locked using uv.
Never use pip, pip-tools, or poetry directly for dependency management.
Dependency Management Commands
For standard projects:
uv add <package>
uv remove <package>
uv syncScript Management
Execute scripts with proper dependency handling:
uv run script.pyManual Inline Metadata Configuration
Scripts can specify dependencies via comment blocks:
# /// 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.pyKey Principles
- Always use
uvfor all package operations - Prefer inline script metadata for standalone scripts
- Use
uv runto execute scripts with their dependencies - Keep dependencies locked and synchronized across environments
- Never fall back to pip or other package managers