Skip to main content

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

Project description

uv

uv image image image Actions status Discord

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

Shows a bar chart with benchmark results.

Installing Trio's dependencies with a warm cache.

Highlights

uv is backed by Astral, the creators of Ruff.

Installation

Install uv with our standalone installers:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Or, from PyPI:

# With pip.
pip install uv
# Or pipx.
pipx install uv

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

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:

$ 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
Audited 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:

$ 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:

$ uv run example.py
Reading inline script metadata from: example.py
Installed 5 packages in 12ms
<Response [200]>

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 in an ephemeral environment using uvx (an alias for uv tool run):

$ uvx pycowsay 'hello world!'
Resolved 1 package in 167ms
Installed 1 package in 9ms
 + pycowsay==0.0.0.2
  """

  ------------
< hello world! >
  ------------
   \   ^__^
    \  (oo)\_______
       (__)\       )\/\
           ||----w |
           ||     ||

Install a tool with uv tool install:

$ uv tool install ruff
Resolved 1 package in 6ms
Installed 1 package in 2ms
 + ruff==0.5.0
Installed 1 executable: ruff

$ ruff --version
ruff 0.5.0

See the tools documentation to get started.

Python versions

uv installs Python and allows quickly switching between versions.

Install multiple Python versions:

$ uv python install 3.10 3.11 3.12
Searching for Python versions matching: Python 3.10
Searching for Python versions matching: Python 3.11
Searching for Python versions matching: Python 3.12
Installed 3 versions in 3.42s
 + cpython-3.10.14-macos-aarch64-none
 + cpython-3.11.9-macos-aarch64-none
 + cpython-3.12.4-macos-aarch64-none

Download Python versions as needed:

$ uv venv --python 3.12.0
Using Python 3.12.0
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

$ uv run --python pypy@3.8 -- python --version
Python 3.8.16 (a9dbdca6fc3286b0addd2240f11d97d8e8de187a, Dec 29 2022, 11:45:30)
[PyPy 7.3.11 with GCC Apple LLVM 13.1.6 (clang-1316.0.21.2.5)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>>

Use a specific Python version in the current directory:

$ uv python pin 3.11
Pinned `.python-version` to `3.11`

See the Python installation documentation to get started.

The pip interface

uv provides a drop-in replacement for common pip, pip-tools, and virtualenv commands.

uv extends their interfaces with advanced features, such as dependency version overrides, platform-independent resolutions, reproducible resolutions, alternative resolution strategies, and more.

Migrate to uv without changing your existing workflows — and experience a 10-100x speedup — with the uv pip interface.

Compile requirements into a platform-independent requirements file:

$ uv pip compile docs/requirements.in \
   --universal \
   --output-file docs/requirements.txt
Resolved 43 packages in 12ms

Create a virtual environment:

$ uv venv
Using Python 3.12.3
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

Install the locked requirements:

$ uv pip sync docs/requirements.txt
Resolved 43 packages in 11ms
Installed 43 packages in 208ms
 + babel==2.15.0
 + black==24.4.2
 + certifi==2024.7.4
 ...

See the pip interface documentation to get started.

Platform support

See uv's platform support document.

Versioning policy

See uv's versioning policy document.

Contributing

We are passionate about supporting contributors of all levels of experience and would love to see you get involved in the project. See the contributing guide to get started.

Acknowledgements

uv's dependency resolver uses PubGrub under the hood. We're grateful to the PubGrub maintainers, especially Jacob Finkelman, for their support.

uv's Git implementation is based on Cargo.

Some of uv's optimizations are inspired by the great work we've seen in pnpm, Orogene, and Bun. We've also learned a lot from Nathaniel J. Smith's Posy and adapted its trampoline for Windows support.

License

uv is licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in uv by you, as defined in the Apache-2.0 license, shall be dually licensed as above, without any additional terms or conditions.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uv-0.6.7.tar.gz (3.1 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

uv-0.6.7-py3-none-win_arm64.whl (16.1 MB view details)

Uploaded Python 3Windows ARM64

uv-0.6.7-py3-none-win_amd64.whl (17.3 MB view details)

Uploaded Python 3Windows x86-64

uv-0.6.7-py3-none-win32.whl (15.9 MB view details)

Uploaded Python 3Windows x86

uv-0.6.7-py3-none-musllinux_1_1_x86_64.whl (16.6 MB view details)

Uploaded Python 3musllinux: musl 1.1+ x86-64

uv-0.6.7-py3-none-musllinux_1_1_i686.whl (15.7 MB view details)

Uploaded Python 3musllinux: musl 1.1+ i686

uv-0.6.7-py3-none-musllinux_1_1_armv7l.whl (15.5 MB view details)

Uploaded Python 3musllinux: musl 1.1+ ARMv7l

uv-0.6.7-py3-none-manylinux_2_28_aarch64.whl (15.4 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ ARM64

uv-0.6.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (16.5 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

uv-0.6.7-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl (20.9 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ s390x

uv-0.6.7-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (16.8 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ppc64le

uv-0.6.7-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl (17.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ppc64

uv-0.6.7-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl (16.2 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ i686

uv-0.6.7-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (15.5 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARMv7l

uv-0.6.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl (15.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64musllinux: musl 1.1+ ARM64

uv-0.6.7-py3-none-macosx_11_0_arm64.whl (14.7 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

uv-0.6.7-py3-none-macosx_10_12_x86_64.whl (15.9 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

uv-0.6.7-py3-none-linux_armv6l.whl (15.8 MB view details)

Uploaded Python 3

File details

Details for the file uv-0.6.7.tar.gz.

File metadata

  • Download URL: uv-0.6.7.tar.gz
  • Upload date:
  • Size: 3.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.6

File hashes

Hashes for uv-0.6.7.tar.gz
Algorithm Hash digest
SHA256 aa558764265fb69c89c6b5dc7124265d74fb8265d81a91079912df376ff4a3b2
MD5 b729178d4f084d74c287c9f72c32890b
BLAKE2b-256 8e58917d104f948aea6580d789189028f02835f5c57729c5bc8f7f4a2e588456

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-win_arm64.whl.

File metadata

  • Download URL: uv-0.6.7-py3-none-win_arm64.whl
  • Upload date:
  • Size: 16.1 MB
  • Tags: Python 3, Windows ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.6

File hashes

Hashes for uv-0.6.7-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 8c968ecabb39f3a6909435afc1ed84dc58cae05c99398f1975a0c5e22e4e8b1e
MD5 e0c2d3a3bdc622382e47709d953eacf7
BLAKE2b-256 e6ae7272683b14691e80ef840bed206cc5530727d07a98af6f9c4844315ee07d

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-win_amd64.whl.

File metadata

  • Download URL: uv-0.6.7-py3-none-win_amd64.whl
  • Upload date:
  • Size: 17.3 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.6

File hashes

Hashes for uv-0.6.7-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 9bccdef3983f0d31830f3cbe6d00384a1d2d5a7175023ba6c5a8acea2804106a
MD5 33d509a7b288a5bacf9e47335bb6f923
BLAKE2b-256 da88f4801ec3a702d62d3f8ccb07ff01a80ed191deb7d0dd698928a289c2b18b

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-win32.whl.

File metadata

  • Download URL: uv-0.6.7-py3-none-win32.whl
  • Upload date:
  • Size: 15.9 MB
  • Tags: Python 3, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.6

File hashes

Hashes for uv-0.6.7-py3-none-win32.whl
Algorithm Hash digest
SHA256 10465c6ec8a02b75deeef45f7b97fe74ae1ee9148b8f6fdd4c84fc4876de5745
MD5 251bbc6fe78001d01961bbc2b1bee739
BLAKE2b-256 427c2b5613e08cb21696e1a5fc39a5a223bfec65f3ca9e33a46756760d11dfc9

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-musllinux_1_1_x86_64.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 57be4e71104bf0244c9b19940bc877d1a7966c0ef43851950f56d2b8d18a8a5b
MD5 d67b330d21d0184ad8f2d063b069b0b3
BLAKE2b-256 a03fa9cb127a8a27a8f11554363f247e7a999ffd5710817c5a3b93d5be817415

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-musllinux_1_1_i686.whl.

File metadata

  • Download URL: uv-0.6.7-py3-none-musllinux_1_1_i686.whl
  • Upload date:
  • Size: 15.7 MB
  • Tags: Python 3, musllinux: musl 1.1+ i686
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.6

File hashes

Hashes for uv-0.6.7-py3-none-musllinux_1_1_i686.whl
Algorithm Hash digest
SHA256 a572ce4c1286092414ada69ed05de4b2aca3666f30aa5b119191ccb30c7d96d6
MD5 20614d93e4499bdf097e28a329aab5fb
BLAKE2b-256 b533435769870724bcace2b7feb94db1563fc44cb8142c864fef9cffe88f0eb9

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-musllinux_1_1_armv7l.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-musllinux_1_1_armv7l.whl
Algorithm Hash digest
SHA256 2cfc48a4b0cd10df5950d41503798f1b785f33eb0ab1cadf9ceb4a03839e5a48
MD5 dd9bce70017c461331e7fcc70a5ea5ed
BLAKE2b-256 6bc5091019d977fddb22a5c3fa1109959a23ca6e8467b4bcb24daa7926157e96

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 97e57773e6107ee578d2483e2cb1342dc2b9379d20f9e559668f053599347caf
MD5 7172688d0e2c4ca753799089f7348687
BLAKE2b-256 1555fddb1bb590e6d9782b16ab120e5c96ec95a29663c9b9e55e7655475767e7

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 840aa6212289f27d56b2c0cbeb4e95cb5726da8674663ab27d4ec80e3be2a081
MD5 1e56f37d9e54e707094d869fccfb27cb
BLAKE2b-256 fbff4d56098d39638b69255b4e2377bbf0243a177745f703ab2af8c26002c071

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
Algorithm Hash digest
SHA256 8efd1da986f1380d4b225e1a2e39d5870697487775a3db5a24358b09946a431d
MD5 d7551f1b237cfb6e7ec60d90f16822d4
BLAKE2b-256 85fb6bd6006ac1832ccb93aab19d154b75bbcab543183f3faf15be24145e2bc7

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Algorithm Hash digest
SHA256 04832e48d87328f75d7b59a2d00ee3ed3060eaca4777924dba1515f0c00ff5ac
MD5 9a2dc9037d378801ed6338e353138b4b
BLAKE2b-256 bca92b509469393b27380fa20e08c800898c07427887eb46f6472df69253ac29

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl
Algorithm Hash digest
SHA256 02bcb6e57aaa147b89bdcd55f5ef6c23b18883c8ce0859dafb2f1cf32ae010e3
MD5 78423785479e8b70baa9c3b28b0635a9
BLAKE2b-256 6cc571eeeee0626719d47dc3cdb563f3b04c46bba566917f8aa572d76e1decbb

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 32ba45607c9140e8d391a5fd22d5d0b22fc7e0ce76988a39c6aeeb0065bc348a
MD5 fa9a78358262609263dd3f7aeb0a9932
BLAKE2b-256 bc958123440acb3efa4f5779026d27b9a54da76c75fdc74aa53e2243b4c3e1cc

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm Hash digest
SHA256 2f09db1158bcc3edad033ee0b5b6a4848af8291e3b271cd76ace3524825d84ea
MD5 c179d40179a69d05c56eba6e38a23bc2
BLAKE2b-256 996e7a7c811e3220f62464390134c7c68b167785d96fc10c5d03a9b99b83fe72

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 04125921e6c670480254f8e63b863b1040bc84d6286f7a8c0b5a4d29f0aa55e9
MD5 12f883fce4e3fe74279edd2cc51376dc
BLAKE2b-256 f979477931ef7169dcb2378711c99540657fe04fd6f0ee45a6647f0a0be5bc83

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 33707fba877cf58cc47406d5910cbfd22cdb2e19451e8b79857d4699650ed37c
MD5 1d2102f2462875e1bd1635f3991d40b7
BLAKE2b-256 1a3214cc6acf5179eca4a595ae90a08178e8e1741b9a62ea5688a16f01250bfb

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 b4beed4004f3cc9b2691d21c40a9a2ff3ddb0e2bb42cacc9545b58bec19c9df7
MD5 e51bc51eb9fe031f1843538ad7ff17a6
BLAKE2b-256 d12443951bfb8af81149a93dddde3aab6a1dfbda3d39eeb5e80445614e1b7bfa

See more details on using hashes here.

File details

Details for the file uv-0.6.7-py3-none-linux_armv6l.whl.

File metadata

File hashes

Hashes for uv-0.6.7-py3-none-linux_armv6l.whl
Algorithm Hash digest
SHA256 d069bf5f02a5ccc7bff5f4a047e9b11569cb8c1f26db5ec3ee78e30b36ade0a6
MD5 e322d599c2cff73df4887b9ab200be3e
BLAKE2b-256 e514988fceeca6a73cb68fa89d4d4e252b13de456ba7cfed6cccf1f7d5c68d09

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page