README

uv





An extremely fast Python package and project manager, written in Rust.


  
    
    
    
  



  Installing Trio's dependencies with a warm cache.


 Highlights

- A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and
  more.
- 10-100x faster than pip.
- Provides comprehensive project management, with a
  universal lockfile.
- Runs scripts, with support for
  inline dependency metadata.
- Installs and manages Python versions.
- Runs and installs tools published as Python packages.
- Includes a pip-compatible interface for a performance boost with a familiar
  CLI.
- Supports Cargo-style workspaces for
  scalable projects.
- Disk-space efficient, with a global cache for
  dependency deduplication.
- Installable without Rust or Python via curl or pip.
- Supports macOS, Linux, and Windows.

uv is backed by Astral, the creators of
Ruff and ty.

 Installation

Install uv with our standalone installers:

bash
 On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh


bash
 On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"


Or, from PyPI:

bash
 With pip.
pip install uv


bash
 Or pipx.
pipx install uv


If installed via the standalone installer, uv can update itself to the latest version:

bash
uv self update


See the installation documentation for
details and alternative installation methods.

 Documentation

uv's documentation is available at docs.astral.sh/uv.

Additionally, the command line reference documentation can be viewed with uv help.

 Features

 Projects

uv manages project dependencies and environments, with support for lockfiles, workspaces, and more,
similar to rye or poetry:

console
$ uv init example
Initialized project example at /home/user/example

$ cd example

$ uv add ruff
Creating virtual environment at: .venv
Resolved 2 packages in 170ms
   Built example @ file:///home/user/example
Prepared 2 packages in 627ms
Installed 2 packages in 1ms
 + example==0.1.0 (from file:///home/user/example)
 + ruff==0.5.0

$ uv run ruff check
All checks passed!

$ uv lock
Resolved 2 packages in 0.33ms

$ uv sync
Resolved 2 packages in 0.70ms
Checked 1 package in 0.02ms


See the project documentation to get started.

uv also supports building and publishing projects, even if they're not managed with uv. See the
publish guide to learn more.

 Scripts

uv manages dependencies and environments for single-file scripts.

Create a new script and add inline metadata declaring its dependencies:

console
$ echo 'import requests; print(requests.get("https://astral.sh"))'  example.py

$ uv add --script example.py requests
Updated example.py


Then, run the script in an isolated virtual environment:

console
$ uv run example.py
Reading inline script metadata from: example.py
Installed 5 packages in 12ms



See the scripts documentation to get started.

 Tools

uv executes and installs command-line tools provided by Python packages, similar to pipx.

Run a tool 

Top issues

Latest release

Release Notes

Released on 2026-11-03.

 Preview features

- Add --output-version to uv workspace metadata for requesting a specific schema version (22958)
- Report aliased OSV records as a single vulnerability in uv audit (22990)

 Bug fixes

- Treat workspace member paths added by uv init or uv add as literals instead of glob patterns (23008)
- Prevent uv's Windows trampolines from closing handles they did not inherit (22977)
- Allow uvx to run tools with CPython builds whose versions contain local identifiers (23013)
- Generate valid module names when uv init creates packaged projects whose