UV Cheat Sheet
This is a uv quick cheat sheet.
Python Versions
# List available and installed Python versions
uv python list
# List all available Python versions that can be installed
uv python list --all-versions
# Install Python 3.14
uv python install 3.14
Project Setup
# Create new project using Python 3.14
uv init my-project --python 3.14
# Pin the Python version to 3.14 for the current project (creates/updates .python-version file)
uv python pin 3.14
# Add pandas as a dependency
uv add pandas
# Add pandas with version constraint
uv add 'pandas>=2.0.1'
# Add pytest as a dev dependency
uv add pytest --dev
# Add dependencies from requirements.txt with constraints
uv add -r requirements.txt -c constraints.txt
# Show available versions of pandas
uvx pip index versions pandas
# Install all dependencies
uv sync
# Install all + dev dependencies
uv sync --dev
# Remove pandas
uv remove pandas
# Run main.py in project environment
uv run main.py
# Run pytest in project environment
uv run pytest
# Show dependency tree
uv tree
Python CLI Tool Management
# Add a CLI tool
uv tool install jupyterlab
# List available Python CLI tools managed by uv
uv tool list
# Remove the installed tool
uv tool uninstall jupyterlab
# Upgrade the installed tool
uv tool upgrade jupyterlab
# Run jupyterlab from PyPI package using uvx
uvx --from jupyterlab jupyter-lab
uv Maintenance
# Clear cached packages
uv cache clean
# Update uv to latest version
uv self update