uv

Create a new Python project

$ uv init [project_name]

$ uv add [package]

$ uv remove [package]

$ uv sync

$ uv run [command]

$ uv python install [3.12]

$ uv venv

$ uv tool install [ruff]

uv command [options] [arguments]

uv is an extremely fast Python package and project manager written in Rust. It replaces pip, pip-tools, pipx, poetry, pyenv, and virtualenv with a single unified tool.
Projects are managed through pyproject.toml with dependencies locked in uv.lock. The uv sync command installs exact versions from the lock file, ensuring reproducible environments.
UV manages Python versions directly—no need for pyenv. Use uv python install to download and manage multiple Python versions.
The tool provides a pip-compatible interface (uv pip) for drop-in replacement in existing workflows, while offering project-based workflows for new projects.

init [name]

Create a new Python project

Add a dependency to pyproject.toml

Remove a dependency

Sync dependencies with lock file

Generate/update uv.lock file

Run command in project environment

Install a Python version

List installed Python versions

Create a virtual environment

Install package (pip-compatible interface)

Install a CLI tool globally

Run a tool without installing

Show help

Show version

UV is relatively new (2024) and rapidly evolving. Some edge cases may differ from pip behavior.
Lock files should be committed to version control for reproducibility. Run uv lock after modifying dependencies.
For CI/CD, use uv sync --frozen to fail if lock file is outdated rather than regenerating it.

UV was created by Astral (makers of Ruff) and released in 2024. It achieved 10-100x faster performance than pip by leveraging Rust and parallel downloads. The tool quickly gained adoption as a modern Python toolchain replacement.

pip(1), poetry(1), pipx(1), python(1)