0.4.23

Release Notes

This release introduces a revamped system for defining package indexes, as an alternative to the existing pip-style
--index-url and --extra-index-url configuration options.

You can now define named indexes in your pyproject.toml file using the [[tool.uv.index]] table:

[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"

Packages can be pinned to a specific index via tool.uv.sources, to ensure that a given package is installed from the
correct index. For example, to ensure that torch is always installed from the pytorch index:

[tool.uv.sources]
torch = { index = "pytorch" }

[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"

Indexes can also be marked as explicit = true to prevent packages from being installed from that index
unless explicitly pinned. For example, to ensure that torch is installed from the pytorch index, but all other
packages are installed from the default index:

[tool.uv.sources]
torch = { index = "pytorch" }

[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

To define an additional index outside a pyproject.toml file, use the --index command-line argument
(or the UV_INDEX environment variable); to replace the default index (PyPI), use the --default-index command-line
argument (or UV_DEFAULT_INDEX).

These changes are entirely backwards-compatible with the deprecated --index-url and --extra-index-url options,
which continue to work as before.

See the Index documentation for more.

Enhancements

• Add index URLs when provided via uv add --index or --default-index (#7746)
• Add support for named and explicit indexes (#7481)
• Add templates for popular build backends (#7857)
• Allow multiple pinned indexes in tool.uv.sources (#7769)
• Allow users to incorporate Git tags into dynamic cache keys (#8259)
• Pin named indexes in uv add (#7747)
• Respect named --index and --default-index values in tool.uv.sources (#7910)
• Update to latest PubGrub version (#8245)
• Enable environment variable authentication for named indexes (#7741)
• Avoid showing lower-bound warning outside of explicit lock and sync (#8234)
• Improve logging during lock errors (#8258)
• Improve styling of requires-python warnings (#8240)
• Show hint in resolution failure on Forbidden (403) or Unauthorized (401) (#8264)
• Update to latest cargo-dist version (includes new installer features) (#8270)
• Warn when patch version in requires-python is implicitly 0 (#7959)
• Add more context on client errors during range requests (#8285)

Bug fixes

• Avoid writing duplicate index URLs with --emit-index-url (#8226)
• Fix error leading to out-of-bound panic in uv-pep508 (#8282)
• Fix managed distributions of free-threaded Python on Windows (#8268)
• Fix selection of free-threaded interpreters during default Python discovery (#8239)
• Ignore sources in build requirements for non-source trees (#8235)
• Invalid cache when adding lower bound to lockfile (#8230)
• Respect index priority when storing credentials (#8256)
• Respect relative paths in uv build sources (#8237)
• Narrow what the pip3. logic drops from entry points. (#8273)

Documentation

• Add some additional notes to --index-url docs (#8267)
• Add upgrade note to README (#7937)
• Remove note that "only a single source may be defined for each dependency" (#8243)

Install uv 0.4.23

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.23

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.22

Release Notes

Enhancements

• Respect [tool.uv.sources] in build requirements (#7172)

Preview features

• Add a dedicated uv publish error message for missing usernames (#8045)
• Support interactive input in uv publish (#8158)
• Use raw filenames in uv publish (#8204)

Performance

• Reuse the result of which git (#8224)

Bug fixes

• Avoid environment check optimization for uv pip install --exact (#8219)
• Do not use free-threaded interpreters without a free-threaded request (#8191)
• Don't recommend --prerelease=allow during build requirement resolution errors (#8192)
• Prefer optimized builds for free-threaded Python downloads (#8196)
• Retain old python-build-standalone releases (#8216)
• Run uv build builds in the source distribution bucket (#8220)

Install uv 0.4.22

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.22

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.21

Release Notes

Enhancements

• Add support for managed installations of free-threaded Python (#8100)
• Add note about uvx to uv tool run short help (#7695)
• Enable HTTP/2 requests (#8049)
• Support uv tree --no-dev (#8109)
• Support PEP 723 metadata with uv run - (#8111)
• Support pip install --exact (#8044)
• Support uv export --no-header (#8096)
• ADd Python 3.13 images to Docker publish (#8105)
• Support remote (https://) scripts in uv run (#6375)
• Allow comma value-delimited arguments in uv run --with (#7909)

Configuration

• Support wildcards in UV_INSECURE_HOST (#8052)

Performance

• Use shared index when fetching metadata in lock satisfaction routine (#8147)

Bug fixes

• Add prerelease compatibility check to uv python CLI (#8020)
• Avoid deleting a project environment directory if we cannot tell if a pyvenv.cfg file exists (#8012)
• Avoid excluding valid wheels for exact requires-python bounds (#8140)
• Bump netrc crate to latest commit (#8021)
• Fix uv python pin 3.13t failure when parsing version for project requires check (#8056)
• Fix handling of != intersections in requires-python (#7897)
• Remove the newly created tool environment if sync failed (#8038)
• Respect dynamic extras in uv lock and uv sync (#8091)
• Treat resolver failures as fatal in lockfile validation (#8083)
• Use git config --get for author information for improved backwards compatibility (#8101)
• Use comma-separated values for UV_FIND_LINKS (#8061)
• Use shared resolver state between add and lock to avoid double Git update (#8146)
• Make --relocatable entrypoints robust to symlinking (#8079)
• Improve compatibility with VSCode PS1 prompt (#8006)
• Fix "Stream did not contain valid UTF-8" failures in Windows (#8120)
• Use --with-requirements in uvx error hint (#8112)

Documentation

• Include uvx installation in Docker examples (#8179)
• Make the instructions for the Windows standalone installer consistent across README and documentation (#8125)
• Update pip compatibility guide to note transitive URL dependency support (#8081)
• Document --reinstall with --exclude-newer to ensure downgrades (#6721)

Install uv 0.4.21

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.21

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.20

Release Notes

Enhancements

• Add managed downloads for CPython 3.13.0 (final) (#8010)
• Python 3.13 is the default version for uv python install (#8010)
• Hint at wrong endpoint in uv publish failures (#7872)
• List available scripts when a command is not specified for uv run (#7687)
• Fill in authors field during uv init (#7756)

Documentation

• Add snapshot testing to contribution guide (#7882)
• Fix and improve GitLab integration docs (#8000)

Install uv 0.4.20

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.20

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.19

Release Notes

Enhancements

• Add managed downloads for CPython 3.13.0rc3 and 3.12.7 (#7880)
• Display the target virtual environment path if non-default (#7850)
• Preserve case-insensitive sorts in uv add (#7864)
• Respect project upper bounds when filtering wheels on requires-python (#7904)
• Add --script to uv run to treat an input as PEP 723 regardless of extension (#7739)
• Improve legibility of build failure errors (#7854)
• Show interpreter source during Python discovery query errors (#7928)

Configuration

• Add UV_FIND_LINKS environment variable for --find-links (#7912)
• Ignore empty string values for UV_PYTHON environment variable (#7878)

Bug fixes

• Allow py3x-none tags in newer than Python 3.x (#7867)
• Allow self-dependencies in the dev section (#7943)
• Always ignore cp2 wheels in resolution (#7902)
• Clear the publish progress bar on retry (#7921)
• Fix parsing of gnueabi libc variants in Python version requests (#7975)
• Simplify supported environments when comparing to lockfile (#7894)
• Trim commits when reading from Git refs (#7922)
• Use a higher HTTP read timeout when publishing packages (#7923)
• Remove the first empty line for uv tree --package foo (#7885)

Documentation

• Add 3.13 support to the platform reference (#7971)
• Clarify project environment creation a little (#7941)
• Fix code block title in Gitlab integration docs (#7861)
• Fix documentation (projects guide) regarding adding a git dependency (#7916)
• fix uninstallation command for windows on documentation (#7944)
• Clearly specify the minimum supported Windows Server version in the document (#7946)

Rust API

• Remove unused Sha256Reader (#7929)
• Remove unnecessary Deserialize derives on settings (#7856)

Install uv 0.4.19

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.19

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.18

Release Notes

Enhancements

• Allow multiple source entries for each package in tool.uv.sources (#7745)
• Add .gitignore file to uv build output directory (#7835)
• Disable jemalloc on FreeBSD (#7780)
• Respect PAGER env var when paging in uv help command (#5511)
• Support uv run -m foo to run a module (#7754)
• Use a top-level output directory for uv build in workspaces (#7813)
• Update uv init --package command to match project name (#7670)
• Add a custom suggestion for uv add dotenv (#7799)
• Add detailed errors for tool.uv.sources deserialization failures (#7823)
• Improve error message copy for failed builds (#7849)
• Use serde-untagged to improve some untagged enum error messages (#7822)
• Use build failure hints for dotenv errors, rather than in uv add (#7825)

Configuration

• Add UV_NO_SYNC environment variable (#7752)

Bug fixes

• Accept git+ prefix in tool.uv.sources (#7847)
• Allow spaces in path requirements (#7767)
• Avoid reusing cached downloaded binaries with --no-binary (#7772)
• Correctly trims values during wheel WHEEL file parsing (#7770)
• Fix uv tree --invert for platform dependencies (#7808)
• Fix encoding mismatch between python child process and uv (#7757)
• Reject self-dependencies in uv add (#7766)
• Respect tool.uv.environments for legacy virtual workspace roots (#7824)
• Retain empty extras on workspace members (#7762)
• Use file stem when parsing cached wheel names (#7773)

Rust API

• Make FlatDistributions public (#7833)

Documentation

• Fix table of contents sizing (#7751)
• GitLab Integration documentation (#6857)
• Update documentation to setup-uv@v3 (#7807)
• Use uv publish instead of twine in docs (#7837)
• Fix typo in projects.md (#7784)

Install uv 0.4.18

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.18

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.17

Release Notes

Enhancements

• Add uv build --all to build all packages in a workspace (#7724)
• Add support for uv init --script (#7565)
• Add support for upgrading build environment for installed tools (uv tool upgrade --python) (#7605)
• Initialize a Git repository in uv init (#5476)
• Respect --quiet flag in uv build (#7674)
• Add context message before listing available tools in uvx (#7641)

Bug fixes

• Don't create Python bytecode files during interpreter discovery (#7707)
• Escape glob patterns in workspace member discovery (#7709)
• Avoid prefetching source distributions with unbounded lower-bound ranges (#7683)

Documentation

• Add uv build and uv publish to features overview (#7716)
• Add documentation on cache versioning (#7693)
• Spell out the names of the Docker images for easier copy-paste (#7706)
• Document uv-with-Jupyter workflows (#7625)
• Note that uv lock --upgrade-package retains locked versions (#7694)

Install uv 0.4.17

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.17

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.16

Release Notes

Enhancements

• Add uv publish (#7475)
• Add a --project argument to run a command from a project directory (#7603)
• Display Python implementation when creating environments (#7652)
• Implement trusted publishing for uv publish (#7548)
• Respect lockfile preferences for --with requirements (#7627)
• Unhide the --directory option (#7653)
• Allow requesting free-threaded Python interpreters (#7431)
• Show a dedicated PubGrub hint for --unsafe-best-match (#7645)
• Add resolver error checking for conflicting distributions (#7595)

Bug fixes

• Avoid adding double-newlines for CRLF (#7640)
• Avoid retaining forks when requires-python range changes (#7624)
• Determine if pre-release Python downloads should be allowed using the version specifiers (#7638)
• Fix link-mode=clone for directories on Linux (#7620)
• Improve Python executable name discovery when using alternative implementations (#7649)
• Require opt-in to use alternative Python implementations (#7650)
• Use the first pre-release discovered when only pre-release Python versions are available (#7666)

Documentation

• Document environment variable that disables printing of virtual environment name in prompt (#7648)
• Remove double whitespaces from the code (#7623)
• Use anchorlinks rather than permalinks (#7626)

Preview features

• Add build backend scaffolding (#7662)

Install uv 0.4.16

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.16

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.15

Release Notes

Bug fixes

• Revert "Treat invalid platform as more compatible than invalid Python (#7556)" (#7608)

Documentation

• Add the execution policy to powershell installs for single versions (#7602)

Install uv 0.4.15

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.15

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum

0.4.14

Release Notes

Breaking

• Move uvx shell completion to uvx --generate-shell-completion (#7511)

Enhancements

• Adjust messaging for frozen hint on resolution failure during uv add (#7597)
• Provide resolution hints in case of possible local name conflicts (#7505)
• Improve Docker image release tagging order and display on ghcr.io (#7568)
• Improve deserialization error messages (#7598)

Bug fixes

• Allow system environments during project environment validity check (#7585)
• Avoid validating workspace members when --no-sources is provided (#7599)
• Fix handling of sys.base_prefix collision in interpreter identity check during tool installs (#7596)
• Make uv cache prune robust to unreadable rkyv entries (#7561)
• Revert "Remove duplicate warning for settings discovery errors (#7384)" (#7594)

Documentation

• Fix - to _ in packaged applications document (#7571)

Install uv 0.4.14

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.4.14

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-i686-pc-windows-msvc.zip	x86 Windows	checksum
uv-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
uv-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
uv-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
uv-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
uv-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
uv-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
uv-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
uv-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
uv-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
uv-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
uv-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
uv-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
uv-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum