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

Navigation

Verified details

These details have been verified by PyPI
Project links
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
Meta
  • License: Apache Software License, MIT License (MIT OR Apache-2.0)
  • Author: uv
  • Tags uv , requirements , packaging
  • Requires: Python >=3.8
Classifiers
Report project as malware

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

Project management

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!

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.

Tool management

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 management

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.

Script support

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.

A pip-compatible 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

Verified details

These details have been verified by PyPI
Project links
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
Meta
  • License: Apache Software License, MIT License (MIT OR Apache-2.0)
  • Author: uv
  • Tags uv , requirements , packaging
  • Requires: Python >=3.8
Classifiers

Release history Release notifications | RSS feed

0.11.14

0.11.13

0.11.12

0.11.11

0.11.10

0.11.9

0.11.8

0.11.7

0.11.6

0.11.5

0.11.4

0.11.3

0.11.2

0.11.1

0.11.0

0.10.12

0.10.11

0.10.10

0.10.9

0.10.8

0.10.7

0.10.6

0.10.5

0.10.4

0.10.3

0.10.2

0.10.1

0.10.0

0.9.30

0.9.29

0.9.28

0.9.27

0.9.26

0.9.25

0.9.24

0.9.23

0.9.22

0.9.21

0.9.20

0.9.19

0.9.18

0.9.17

0.9.16

0.9.15

0.9.14

0.9.13

0.9.12

0.9.11

0.9.10

0.9.9

0.9.8

0.9.7

0.9.6

0.9.5

0.9.4

0.9.3

0.9.2

0.9.1

0.9.0

0.8.24

0.8.23

0.8.22

0.8.21

0.8.20

0.8.19

0.8.18

0.8.17

0.8.16

0.8.15

0.8.14

0.8.13

0.8.12

0.8.11

0.8.10

0.8.9

0.8.8

0.8.7

0.8.6

0.8.5

0.8.4

0.8.3

0.8.2

0.8.1

0.8.0

0.7.22

0.7.21

0.7.20

0.7.19

0.7.18

0.7.17

0.7.16

0.7.15

0.7.14

0.7.13

0.7.12

0.7.11

0.7.10

0.7.9

0.7.8

0.7.7

0.7.6

0.7.5

0.7.4

0.7.3

0.7.2

0.7.1

0.7.0

0.6.17

0.6.16

0.6.15

0.6.14

0.6.13

0.6.12

0.6.11

0.6.10

0.6.9

0.6.8

0.6.7

0.6.6

0.6.5

0.6.4

0.6.3

0.6.2

0.6.1

0.6.0

0.5.31

0.5.30

0.5.29

0.5.28

0.5.27

0.5.26

0.5.25

0.5.24

0.5.23

0.5.22

0.5.21

0.5.20

0.5.19

0.5.18

0.5.17

0.5.16

This version

0.5.15

0.5.14

0.5.13

0.5.12

0.5.11

0.5.10

0.5.9

0.5.8

0.5.7

0.5.6

0.5.5

0.5.4

0.5.3

0.5.2

0.5.1

0.5.0

0.4.30

0.4.29

0.4.28

0.4.27

0.4.26

0.4.25

0.4.24

0.4.23

0.4.22

0.4.21

0.4.20

0.4.19

0.4.18

0.4.17

0.4.16

0.4.15

0.4.14

0.4.13

0.4.12

0.4.11

0.4.10

0.4.9

0.4.8

0.4.7

0.4.6

0.4.5

0.4.4

0.4.3

0.4.2

0.4.1

0.4.0

0.3.5

0.3.4

0.3.3

0.3.2

0.3.1

0.3.0

0.2.37

0.2.36

0.2.35

0.2.34

0.2.33

0.2.32

0.2.31

0.2.30

0.2.29

0.2.28

0.2.27

0.2.26

0.2.25

0.2.24

0.2.23

0.2.22

0.2.21

0.2.20

0.2.19

0.2.18

0.2.17

0.2.16

0.2.15

0.2.14

0.2.13

0.2.12

0.2.11

0.2.10

0.2.9

0.2.8

0.2.7

0.2.6

0.2.5

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.1.45

0.1.44

0.1.43

0.1.42

0.1.41

0.1.40

0.1.39

0.1.38

0.1.37

0.1.36

0.1.35

0.1.34

0.1.33

0.1.32

0.1.31

0.1.30

0.1.29

0.1.28

0.1.27

0.1.26

0.1.25

0.1.24

0.1.23

0.1.22

0.1.21

0.1.20

0.1.19

0.1.18

0.1.17

0.1.16

0.1.15

0.1.14

0.1.13

0.1.12

0.1.11

0.1.10

0.1.9

0.1.8

0.1.7

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

0.0.5

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.5.15.tar.gz (2.6 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.5.15-py3-none-win_amd64.whl (15.9 MB view details)

Uploaded Python 3Windows x86-64

uv-0.5.15-py3-none-win32.whl (14.6 MB view details)

Uploaded Python 3Windows x86

uv-0.5.15-py3-none-musllinux_1_1_x86_64.whl (15.4 MB view details)

Uploaded Python 3musllinux: musl 1.1+ x86-64

uv-0.5.15-py3-none-musllinux_1_1_i686.whl (14.6 MB view details)

Uploaded Python 3musllinux: musl 1.1+ i686

uv-0.5.15-py3-none-musllinux_1_1_armv7l.whl (14.2 MB view details)

Uploaded Python 3musllinux: musl 1.1+ ARMv7l

uv-0.5.15-py3-none-manylinux_2_28_aarch64.whl (14.2 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ ARM64

uv-0.5.15-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (15.2 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

uv-0.5.15-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl (19.8 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ s390x

uv-0.5.15-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (15.5 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ppc64le

uv-0.5.15-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl (15.7 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ppc64

uv-0.5.15-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl (15.0 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ i686

uv-0.5.15-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (14.2 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARMv7l

uv-0.5.15-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl (14.0 MB view details)

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

uv-0.5.15-py3-none-macosx_11_0_arm64.whl (13.6 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

uv-0.5.15-py3-none-macosx_10_12_x86_64.whl (14.7 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

uv-0.5.15-py3-none-linux_armv6l.whl (14.4 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: uv-0.5.15.tar.gz
  • Upload date:
  • Size: 2.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.5.14

File hashes

Hashes for uv-0.5.15.tar.gz
Algorithm Hash digest
SHA256 b624ea5eef977b922a08f23fbd9a476b62fdbe7f54ca3f8dedf82cd4b330ed73
MD5 350dd5f13904794c83a7ca67b769b5d6
BLAKE2b-256 299fcfd7073d714425da8194bc2c32fd3466ca0b6bb92b98e620f374ab7f647b

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for uv-0.5.15-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 e7e3aefb6c7101ba5567138d0fe81834e78d1f74158e11b44867a598fa667df3
MD5 0b3ab8ed3c487764fc678ccee6ec2386
BLAKE2b-256 3eca58eb5f5e88cfbdfe7fac4e71eeb12772257b50d64588900c22daa87559b9

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for uv-0.5.15-py3-none-win32.whl
Algorithm Hash digest
SHA256 39f3df251ae17ed80ff4ce500797b54321c1d4384d2faf5cf46bca3af0c5b9c2
MD5 f3b045b0e33e3d6827d0a071652f197c
BLAKE2b-256 3963b7c551cb9bd3e1d17c56ac364f209e9054fa18c6ac15798e511d16e3c3e9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 3ceb25de833b81077b4b17158c192c05416a09521ff96c79879e04842c4cad4e
MD5 4f33bb077d87e6279d9c6a7f8f9729f3
BLAKE2b-256 ea2cc70b5f8978fcd57e80e1b97364a3bd1242aeb82bbce7e459a124495d96c2

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-musllinux_1_1_i686.whl
Algorithm Hash digest
SHA256 a7bfee425b251b7ac7794262c075d9784850a5315f70a4a62182e1eb4d74dddc
MD5 1b691a4228396304ca2f29b339bc20e7
BLAKE2b-256 562662d47d47c00a803a17588046ae8f55ac98e69a8f9b21258376688f4f2a80

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-musllinux_1_1_armv7l.whl
Algorithm Hash digest
SHA256 c93be8ab085be9d175c2daa21eff16c6117e4725fbcfc9c2734ec03ec5e5e2aa
MD5 b13803b06e8da12d6154bce7bd311c1c
BLAKE2b-256 4ebdb95a8b2918bf42f4e495c4e629158f8018671f3b0600e524395218b9c387

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 cdfa8200a50c3bff4fb9be7833c8c66da7bc714f7e2d6f2ea9aa4e29a4425192
MD5 ea704bb290639c4f355930a890260173
BLAKE2b-256 b9f53f0df8fc7f9ac227ca716c1bda191390ce08f6ab466bc2b833c87a4a5b81

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 1a0f7523d34daec3727bbd8d7c7a53fd9b22d77329a4849f21c38ee94124d061
MD5 0c96d89e9aeacb62d1dc856e42044046
BLAKE2b-256 b7a8208f17a09f08401fe437a55b2bdbeee7ece6fe0a4f6f500878f056e4be8d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
Algorithm Hash digest
SHA256 1b9f9e8f4bdfffcfcc0368c4b9464651a5b428287b91d130d0c8291df64f2846
MD5 2a0f0b08ebb8f657c612cd9d45cae37f
BLAKE2b-256 3f16f33d98d3ca2c10a4411d0d2b0eca12bcb71df0b22a2d88297272bfca02ee

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Algorithm Hash digest
SHA256 d08d47b66ee65adba37727b65278e1c8a9009f172cedcfa4b8d4cf3aca48e39b
MD5 b503c6bbb64ab5310383db27fb6b0836
BLAKE2b-256 9cefb11855e8fd8fef3c124230e9daae84f51abdf0464d489bb1d132168a5857

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl
Algorithm Hash digest
SHA256 5605cba0162f1f97ed60ad9eed8919ef733af8326e38380d06323f265bef15de
MD5 6c2f3f6c96ae19547f69de681ed0eb56
BLAKE2b-256 b0994b969e7a9de5b27892867e2138e25605a3c19dc0757632b0c72083259a36

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 de7494e2d86893fb8f36005a66d009c151bd548d437405a7d3e257585b89df30
MD5 0d30ad47bc62d9319f38b2619e8bd80a
BLAKE2b-256 732473be92a4789fb7c9e19a324f0dc35d4ae32e0945fd6ba5c4d16ce5a96611

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm Hash digest
SHA256 a31f8c833121952ca9d9a1edc64ba88810231547beff611e448c1ce813df595a
MD5 512805717c61a04754b62c6ea3d7af8c
BLAKE2b-256 0491db94eb3ffdf99ec2ec48a036fb33c7f2260e85d46d3bc5c2f57189216b52

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 95ce9db23b9d3492d3b8d6a8fc8093820f39440a6319e9baf50f4b362bc6c9bb
MD5 5db542dcb3b8be79bd12de0f46ddcb28
BLAKE2b-256 44518fbf7bcad104df4d559f423cf3782149aac938f121bba4306a8c0f2db0ee

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2a967e063457966c17fd599d8e53c05376d32d056665350cdc5c56f7af0f3eea
MD5 9213ffc8c72ddd92f6b9bda8fdd72c09
BLAKE2b-256 7b173604e9f1fbc512083a82d2db9bd9c0d82d20ea04fe479ad7d11dbdac7198

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 b255cb912247f165a2479a342293afa51a30c7c2f025163ecdbaabb238383379
MD5 9e99d4098afd513e1ec4eceb5258decf
BLAKE2b-256 13ca55389e8b55b7b2419e85eb4748a0553a1aa5bff41697b9c864efc792e593

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uv-0.5.15-py3-none-linux_armv6l.whl
Algorithm Hash digest
SHA256 0a3f5d7218a258be53bd2152bb2eb7305f81dff0542f5a1614458bc9f3a1a87b
MD5 ad4231ea5b4b63800a498c8755b92e92
BLAKE2b-256 c44a5664e07b7b3c30447c50e74d67d15635fcebfa4b3cd2e3de9519063f2425

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