UV

# Install uv
pip install uv

# Or via standalone installer
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a new project
uv init my-project
cd my-project

# Add dependencies
uv add requests numpy

# Install dependencies
uv sync

# Run a script
uv run python main.py

# Run a tool
uv tool run black .

uv init [PATH]                    # Create new project
uv add PACKAGE...                 # Add dependencies
uv remove PACKAGE...              # Remove dependencies
uv sync                          # Update environment to match lockfile
uv run COMMAND                   # Run command in project environment
uv lock                          # Update project lockfile
uv export [--format FORMAT]      # Export lockfile to alternate formats

uv python list                   # List available Python installations
uv python install VERSION       # Install Python version
uv python find [REQUEST]         # Find Python installation
uv python pin VERSION           # Pin project to Python version

uv pip install PACKAGE...        # Install packages
uv pip uninstall PACKAGE...      # Uninstall packages
uv pip compile INPUT_FILE        # Compile requirements file
uv pip sync REQUIREMENTS_FILE    # Sync environment with requirements
uv pip list                      # List installed packages
uv pip freeze                    # Output installed packages in requirements format

uv tool run TOOL [ARGS...]       # Run tool in isolated environment
uv tool install TOOL            # Install tool globally
uv tool list                     # List installed tools
uv tool uninstall TOOL          # Uninstall tool

uv venv [PATH]                   # Create virtual environment

uv build [PATH]                  # Build packages
uv publish [DIST...]             # Publish to index

uv auth login [SERVICE]          # Login to service
uv auth logout [SERVICE]         # Logout from service
uv auth token [SERVICE]          # Show authentication token

uv cache clean                   # Clear cache
uv cache prune                   # Prune unreachable cache objects
uv cache dir                     # Show cache directory

uv self update                   # Update uv
uv self version                  # Show version information

uv help [COMMAND]                # Display help for commands
uv generate-shell-completion     # Generate shell completion scripts
uv clean                         # Legacy alias for cache clean

--help, -h                       # Show help
--version, -V                    # Show version
--quiet, -q                      # Quiet output (repeatable)
--verbose, -v                    # Verbose output (repeatable)
--color CHOICE                   # Color output (auto/always/never)
--no-color                       # Disable colors
--python VERSION                 # Python version to use
--config-file PATH               # Configuration file path
--no-config                      # Skip configuration discovery
--offline                        # Disable network access
--native-tls                     # Use system certificate store
--allow-insecure-host HOST       # Allow insecure connections
--directory PATH                 # Change directory before running
--project PATH                   # Project directory

# Exit codes:
# 0: Success
# 1: General error (command failed)
# 2: Usage error (invalid arguments)

# Available after: pip install uv
import uv

# Find uv binary location (returns pathlib.Path)
binary_path = uv.find_uv_bin()

# Module execution (delegates to native binary)
# python -m uv [commands...]
# Exit codes: 0 (success), 1 (error), 2 (usage error)

# Example usage:
import subprocess
result = subprocess.run(["python", "-m", "uv", "pip", "list"],
                       capture_output=True, text=True)

uvx black .                      # Equivalent to: uv tool run black .
uvx ruff check                   # Equivalent to: uv tool run ruff check