uv Cheatsheet — pip Compatibility

# Create a venv (replaces: python -m venv .venv)
uv venv

# Create with a specific Python version
uv venv --python 3.12

# Create at a custom path
uv venv /path/to/myenv

# Activate (same as always)
source .venv/bin/activate

# Install a package (replaces: pip install requests)
uv pip install requests

# Install with version constraint
uv pip install 'requests>=2.31'

# Install from requirements.txt
uv pip install -r requirements.txt

# Install in editable mode
uv pip install -e .
uv pip install -e ./my-package

# Install with extras
uv pip install 'package[extra1,extra2]'

uv pip uninstall requests
uv pip uninstall -r requirements.txt

# List installed packages
uv pip list

# Show details about a package
uv pip show requests

# Freeze current environment to requirements format
uv pip freeze
uv pip freeze > requirements.txt

# Show dependency tree
uv pip tree

# Compile abstract deps to pinned versions
uv pip compile requirements.in -o requirements.txt

# Cross-platform / universal resolution
uv pip compile requirements.in --universal -o requirements.txt

# Include hashes for supply-chain security
uv pip compile requirements.in --generate-hashes -o requirements.txt

# Upgrade all packages in the compiled output
uv pip compile requirements.in --upgrade -o requirements.txt

# Install exactly what's in requirements.txt, removing extras
uv pip sync requirements.txt

# Platform-independent / universal resolution
uv pip compile --universal requirements.in

# Alternative resolution strategies
uv pip compile --resolution lowest requirements.in

# Dependency overrides
uv pip compile --override overrides.txt requirements.in