astral-sh/uv 0.2.0

on GitHub

Release Notes

Starting with this release, uv will use the minor version tag to indicate breaking changes.

Breaking

In this release, discovery of Python interpreters has changed. These changes should have a limited effect in most
use-cases, however, it has been marked as a breaking change because the interpreter used by uv could change in some edge cases.

When multiple Python interpreters are installed, uv makes an attempt to find the exact version you requested.
Previously, uv would stop at the first Python interpreter it discovered — if the interpreter did not satisfy
the requested version, uv would fail. Now, uv will query multiple Python interpreters until it finds the
requested version, skipping interpreters that are broken or do not satisfy the request.

Additionally, uv now allows requests for interpreter implementations such as pypy and cpython. For example,
the request --python cpython will ignore a python executable that's implemented by pypy. These requests may
also include a version, e.g., --python pypy@3.10. By default, uv will accept any interpreter implementation.

In summary, the following Python interpreter requests are now allowed:

• A Python version without an implementation name, e.g., 3.10
• A path to a directory containing a Python installation, e.g., ./foo/.venv
• A path to a Python executable, e.g., ~/bin/python
• A Python implementation without a version, e.g., pypy or cpython
• A Python implementation name and version, e.g., pypy3.8 or pypy@3.8
• The name of a Python executable (for lookup in the PATH), e.g., foopython3

Previously, interpreter requests that were not versions or paths were always treated as executable names.

To align the user expecations, uv now respects the interpreter that starts it. For example, python -m uv ... will
now prefer the python interpreter that was used to start uv instead of searching for a virtual environment.

Enhancements

• Rewrite Python interpreter discovery (#3266)
• Add support for requesting pypy interpreters by implementation name (#3706)
• Discover and prefer the parent interpreter when invoked with python -m uv #3736
• Add PEP 714 support for HTML API client (#3697)
• Add PEP 714 support for JSON API client (#3698)
• Write relative paths with unnamed requirement syntax (#3682)
• Allow relative Python executable paths in Windows trampoline (#3717)
• Add support for clang and msvc in missing header error (#3753)

CLI

• Allow --constraint files in pip sync (#3741)
• Allow --config-file to be passed before or after command name (#3730)
• Make --offline a global argument (#3729)

Performance

• Improve performance in complex resolutions by reducing cost of PubGrub package clones (#3688)

Bug fixes

• Evaluate arbitrary markers to false (#3681)
• Improve DirWithoutEntrypoint error message (#3690)
• Improve display of root package in range errors (#3711)
• Propagate URL errors in verbatim parsing (#3720)
• Report yanked packages in --dry-run (#3740)

Release

• Drop native manylinux wheel in favor of dual-tagged wheel (#3685)
• The python-patch test feature is no longer on by default and must be manually enabled to test patch version behavior (#3746)

Documentation

• Add --prefix link to compatibility guide (#3734)
• Add --only-binary to compatibility guide (#3735)
• Add instructions for building and updating uv-trampolines (#3731)
• Add notes for testing on Windows (#3658)

Install uv 0.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.2.0/uv-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/astral-sh/uv/releases/download/0.2.0/uv-installer.ps1 | iex"

Download uv 0.2.0