• Repository

Meta

• License: Apache Software License, MIT License (MIT OR Apache-2.0)
• Author: uv
• Tags uv , requirements , packaging
• Requires: Python >=3.8

Classifiers

• Development Status
  • 5 - Production/Stable
• Environment
  • Console
• Intended Audience
  • Developers
• License
  • OSI Approved :: Apache Software License
  • OSI Approved :: MIT License
• Operating System
  • OS Independent
• Programming Language
  • Python
  • Python :: 3 :: Only
  • Python :: 3.8
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
• Topic
  • Software Development :: Libraries
  • Software Development :: Quality Assurance
  • Software Development :: Testing

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

• 🚀 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.

Installation

Install uv with our standalone installers:

# On macOS and Linux.
curl-LsSfhttps://astral.sh/uv/install.sh|sh

# On Windows.
powershell-ExecutionPolicyByPass-c"irm https://astral.sh/uv/install.ps1 | iex"

Or, from PyPI:

# With pip.
pipinstalluv

# Or pipx.
pipxinstalluv

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

uvselfupdate

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:

$ uvinitexample
Initialized project `example` at `/home/user/example`

$ cdexample

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

$ uvrunruffcheck
All checks passed!

$ uvlock
Resolved 2 packages in 0.33ms

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

$ uvadd--scriptexample.pyrequests
Updated `example.py`

Then, run the script in an isolated virtual environment:

$ uvrunexample.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):

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

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

$ uvpythoninstall3.103.113.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:

$ uvvenv--python3.12.0
Using Python 3.12.0
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

$ uvrun--pythonpypy@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:

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

$ uvpipcompiledocs/requirements.in\
--universal\
--output-filedocs/requirements.txt
Resolved 43 packages in 12ms

Create a virtual environment:

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

Install the locked requirements:

$ uvpipsyncdocs/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

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

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.

Verified details

These details have been verified by PyPI

Project links

• Homepage
• Changelog
• Releases
• Repository

GitHub Statistics

Maintainers

👁 Avatar for astral-bot from gravatar.com
astral-bot 👁 Avatar for crmarsh from gravatar.com
crmarsh 👁 Avatar for sarasklenka from gravatar.com
sarasklenka 👁 Avatar for zanie from gravatar.com
zanie

Unverified details

These details have not been verified by PyPI

Project links

• Discord
• Documentation

• Download URL: uv-0.6.10.tar.gz
• Upload date: Mar 26, 2025
• Size: 3.1 MB
• Tags: Source
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10.tar.gz

Algorithm	Hash digest
SHA256	cbbb03deb30af457cd93ad299ee5c3258ade3d900b4dee1af936c8a6d87d5bcb
MD5	e2ed7e9bc1bed2a0865bcdefe705c0c2
BLAKE2b-256	4632ffa984c2ecbcf48d0ae813adf1aad79b3ecb5ffc743362088755d64ae3be

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-win_arm64.whl
• Upload date: Mar 26, 2025
• Size: 16.2 MB
• Tags: Python 3, Windows ARM64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-win_arm64.whl

Algorithm	Hash digest
SHA256	5188dc7041f4166bf64182d76c32c873f750259b6e4621a1400c26ebeea8c8dd
MD5	3b39b63f89cc536bc169bfd1e24b1fe4
BLAKE2b-256	ce07e6ffe467e1e365f7dd7863c4d505b1941af8cf69c494d0dbda08ba907043

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-win_amd64.whl
• Upload date: Mar 26, 2025
• Size: 17.4 MB
• Tags: Python 3, Windows x86-64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-win_amd64.whl

Algorithm	Hash digest
SHA256	d795721fdd32e0471c952b7cb02a030657b6e67625fe836f4df14a3ae4aa4921
MD5	4afdf28bd3a9a437c2dbf62cb03860fd
BLAKE2b-256	8a21a71c95c85624544c56695ae2469745bbda834e77dfc1e29d76711409eda5

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-win32.whl
• Upload date: Mar 26, 2025
• Size: 16.0 MB
• Tags: Python 3, Windows x86
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-win32.whl

Algorithm	Hash digest
SHA256	df6560256b93441c70ea2c062975bce2307a32de280f103cedb8db4a0f542348
MD5	023f821ea71221b8b2f1dab136c6bf18
BLAKE2b-256	75d4df57d3f40c93c21fceed94156da41183daabd15422506e0fe73236c458a1

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-musllinux_1_1_x86_64.whl
• Upload date: Mar 26, 2025
• Size: 16.7 MB
• Tags: Python 3, musllinux: musl 1.1+ x86-64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-musllinux_1_1_x86_64.whl

Algorithm	Hash digest
SHA256	d1f1bc7d94a4a7fdd75142be71b6bf2d7e01282f322721da185d711f065d7b80
MD5	5cdb02d75d1fe9d3015015f66d8c498c
BLAKE2b-256	a29b2c688a897efad60d6e0587027968c1fdb0a63f70a8bef33d0b8154cc0fcd

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-musllinux_1_1_i686.whl
• Upload date: Mar 26, 2025
• Size: 15.9 MB
• Tags: Python 3, musllinux: musl 1.1+ i686
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-musllinux_1_1_i686.whl

Algorithm	Hash digest
SHA256	603aebbaf6be938120c73fd36e9fd85f5e1b671d3d4638b3086f478e2bb423d9
MD5	658a6895814468ac478f35bc8ac68aa5
BLAKE2b-256	093f5637bbf27ac145a09ea8eba8e0c926f7a3fe8fc4b3b1c91131c4558f4ec2

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-musllinux_1_1_armv7l.whl
• Upload date: Mar 26, 2025
• Size: 15.5 MB
• Tags: Python 3, musllinux: musl 1.1+ ARMv7l
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-musllinux_1_1_armv7l.whl

Algorithm	Hash digest
SHA256	5260f52386e217615553f2f42740ce2f64ba439ff0fd502dc5b06250eb8ae613
MD5	a8df62a2b7508ddd20b3bba01104b81d
BLAKE2b-256	ef9719813f2ec2faac77da5548c35d6ae039d044b973ecbb0732e3f07662fd36

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_28_aarch64.whl
• Upload date: Mar 26, 2025
• Size: 15.5 MB
• Tags: Python 3, manylinux: glibc 2.28+ ARM64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_28_aarch64.whl

Algorithm	Hash digest
SHA256	e8a8a75cf34c0814c1eabdbe651741d44fb125a6dcbe159b2da02871bbfdec7e
MD5	48e4086f77b9ea33d964c4165ffb49db
BLAKE2b-256	a1a9124aa76690a04cf30344386358b772cdede17d84660ae1dce8643bf64939

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
• Upload date: Mar 26, 2025
• Size: 16.6 MB
• Tags: Python 3, manylinux: glibc 2.17+ x86-64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Algorithm	Hash digest
SHA256	b98e8884093cbfb1a1cc3f855aa22f97ec8da1a87e0e761800e165d4f9224a45
MD5	5a83e53d710c42a11d39d1a43ecba192
BLAKE2b-256	0ad37e881e2a391203a7567cf03c72213701e63923591d2072c4e7fe694c919f

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
• Upload date: Mar 26, 2025
• Size: 21.2 MB
• Tags: Python 3, manylinux: glibc 2.17+ s390x
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Algorithm	Hash digest
SHA256	666d9fe312c810bba77633dbd463dc85f5a6a0d07905726a014dc53d07c774d9
MD5	7204d6a230d6815f9870746bbde2dc18
BLAKE2b-256	d21463233a3143535a6df34ee6dc8246ef09ee79d99b902a6cc1ee179c1898f9

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
• Upload date: Mar 26, 2025
• Size: 16.9 MB
• Tags: Python 3, manylinux: glibc 2.17+ ppc64le
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Algorithm	Hash digest
SHA256	145e75b99d6b7bdce8e454a851cfcd5605ff0491d568244c66fa75ca6b071bd6
MD5	fe65a6e28fbd2de1cc7f39dbaf417b78
BLAKE2b-256	5e055c9cd846243aca204f96c2da13da0fb38b6143eb3827dedea0e1dc1bcf1c

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl
• Upload date: Mar 26, 2025
• Size: 17.2 MB
• Tags: Python 3, manylinux: glibc 2.17+ ppc64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl

Algorithm	Hash digest
SHA256	13ac09945976dc0df0edde7e4ba3a46107036a114117c8ff84916e55216c2e32
MD5	fbfb3612b88d485fb94530c7ad51c012
BLAKE2b-256	0f149a2e40e25fba7b550cb57cce62a07ddf28350cb53e9e8bd2e70c0fbacdbb

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
• Upload date: Mar 26, 2025
• Size: 16.2 MB
• Tags: Python 3, manylinux: glibc 2.17+ i686
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Algorithm	Hash digest
SHA256	acca1dca7be342b2b8e26e509aa07c3144cb009788140eee045da2aad6a0c6fe
MD5	96f0642fc0ef48f0b1cf22fa40edd434
BLAKE2b-256	3480feb9ecc8ab8f9e1968d6783dd47e7ebd1dfcd0231c8b7b0efd7204625cec

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
• Upload date: Mar 26, 2025
• Size: 15.6 MB
• Tags: Python 3, manylinux: glibc 2.17+ ARMv7l
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Algorithm	Hash digest
SHA256	950c9cd7b75f67e25760d2f43ad4b0ee3f8c6724fe0a9cf9eff948b3044b6a6d
MD5	6a9ef2cc31b7b3610726d37ad4aa3ff7
BLAKE2b-256	5890053bde333fbf9030dff1354797bd74ce3624235bcf59d7558397749a88c1

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
• Upload date: Mar 26, 2025
• Size: 15.3 MB
• Tags: Python 3, manylinux: glibc 2.17+ ARM64, musllinux: musl 1.1+ ARM64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl

Algorithm	Hash digest
SHA256	4dd20c47898c15ebd4b5f48101062ea248e32513bfc61fc04bc822abfe39ce8a
MD5	a72eaf6e76150b83f9d2036adc968584
BLAKE2b-256	5aa213eb03e8691b098f9ee63c4d3fa3a054c48bfa05a0a52aec3df33ab52376

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-macosx_11_0_arm64.whl
• Upload date: Mar 26, 2025
• Size: 14.8 MB
• Tags: Python 3, macOS 11.0+ ARM64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-macosx_11_0_arm64.whl

Algorithm	Hash digest
SHA256	cd8a4bcfd33a0dcae3fc0936bff8602f74e5719cf839e3df233059a0b8c8330d
MD5	10aa69dcf43fc2daa864bbae74c9ee3e
BLAKE2b-256	366bf66dcd28508bceed7cff48efb9dfe62a50a40a0685c41fb5e6ecd45f33cd

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-macosx_10_12_x86_64.whl
• Upload date: Mar 26, 2025
• Size: 16.0 MB
• Tags: Python 3, macOS 10.12+ x86-64
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-macosx_10_12_x86_64.whl

Algorithm	Hash digest
SHA256	e5c2ba1922c47a245d7393465fcee942df5a8bd8b80489a7b8860ba9d60102f9
MD5	dc7dcb11485f432364bb1e6da28607a8
BLAKE2b-256	f72f001f6bb4342ba50cf921bd4a338ea40e5228ea6a817bd3101fbabaf010dd

See more details on using hashes here.

• Download URL: uv-0.6.10-py3-none-linux_armv6l.whl
• Upload date: Mar 26, 2025
• Size: 15.8 MB
• Tags: Python 3
• Uploaded using Trusted Publishing? Yes
• Uploaded via: uv/0.6.9

Hashes for uv-0.6.10-py3-none-linux_armv6l.whl

Algorithm	Hash digest
SHA256	06932d36f1afaf611522a6a7ec361dac48dc67a1147d24e9eadee9703b15faaf
MD5	fa297429092a99ec0779146d7d876e84
BLAKE2b-256	475a5ef9324c333478608eaca8c97a374a869b861a9a614c1e6695045e06d90c

See more details on using hashes here.