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

★ 92,029⑂ 3,833👁 248⑃ 13,536● 9,456▤ 331
RustApache-2.0Created 2023-10-02docs.astral.sh/uv
More from this author
Download: 0.13.80.13.8 ↓0.13.82026-11-12
+32
Daily
+238
Weekly
92,029
stars
3,833
forks
248
watchers
13,536
prs
9,456
issues
331
releases

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

0.13.8 0.13.8 2026-11-12
Release Notes

Released on 2026-11-12.

 Python

- Add CPython 3.16.0a2 (23211)
- Update managed CPython 3.11, 3.12, 3.13, 3.14, and 3.15 builds to include pip 26.3, zlib 1.4, and Expat 2.10.0 (23211)
- Update GraalPy 3.13.0 to build 25.5.5 (23088)

 Preview features

- Install wheel variants from local paths, direct URLs, and Git repositories in platform-specific resolutions (22720, 22722, 22724)
- Detect x86-64 microarchitecture levels and AArch64 architecture versions when selecting wheel variants (22832, 22949)
- Detect Google TPUs up when selecting wheel variants (23066, 23121)
- Fix CPU 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON