uv

astral-sh

90.7k stars3.7k forksRustApache-2.0

packagingpythonresolveruv

A Rust command-line tool that replaces Python packaging tools and manages projects, environments, scripts, tools, and Python versions.

Unlike separate tools for pip, Poetry, pipx, pyenv, and virtualenv, uv puts their Python packaging workflows behind one command-line tool. Run commands such as uv add, uv run, uv tool install, or uv python install to resolve dependencies and create the required environments. Its benchmarks claim 10-100x faster operation than pip, depending on workload and platform.

For Python developers consolidating packaging and environment tools

CLI toolv0.13.1

Use cases

Manage a Python project with locked dependencies and environments
Run single-file Python scripts with inline dependency metadata
Run Python command-line tools in ephemeral isolated environments
Install Python command-line tools as persistent executables
Switch Python interpreter versions per project or command

Key features

Inline script dependencies: PEP 723 metadata creates temporary environments
Ephemeral tool execution: uvx aliases uv tool run
Managed Python installations: Install, pin, and select CPython or PyPy versions
Pip-compatible commands: Supports uv pip compile, sync, and venv
Persistent configuration: Reads uv.toml or [tool.uv] in pyproject.toml
Dotenv support for runs: uv run loads .env files or --env-file

Under the hood

4 parts

uv centralizes Python package resolution, locking, installation, project environments, managed Python installations, scripts, and tools in a Rust command-line application. A shared configuration layer resolves command-line, project, workspace, and user settings before commands run.

README.md (Highlights); crates/uv/src/lib.rs (run); docs/concepts/configuration-files.md

Command application
Initializes global state, loads configuration, and dispatches CLI execution.
crates/uv/src/lib.rs
CLI definitions
Defines command arguments and packaging, project, Python, and cache options.
crates/uv-cli/src/lib.rs
Project command runner
Runs project commands and scripts in managed or ephemeral environments.
crates/uv-project-commands/src/run.rs
Lockfile model
Represents lockfile packages, dependency selections, markers, and workspace metadata.
crates/uv-lock/src/lock/mod.rs

Built with

RustCargoClap 4.5.17Tokio 1.40.0Reqwest 0.13.1Serde 1.0.210MaturinPython packaging standards

Generated 7 hours ago

Analyze another repo