uv

Release Notes

Enhancements

• Allow installation of manylinux wheels on loongarch64 (#10927)
• Allow optional = for editables in requirements.txt (#10954)
• Add Windows aarch64 to the release binaries (#10885)

Bug fixes

• Use spec-compliant (128+n) exit codes for uv run and uv tool run on Unix (#10781)
• Fix best-interpreter lookups when there is an invalid interpreter in the PATH (#11030)
• Guard against concurrent cache writes on Windows (#11007)
• Prioritize package preferences with greater package versions (#10963)
• Reject --editable flag on non-directory requirements (#10994)
• Respect --no-sources for uv pip install workspace discovery (#11003)
• Set JEMALLOC_SYS_WITH_LG_PAGE=16 in ARM Docker builds (#10943)
• Update riscv64 Python downloads to allow install on riscv64gc (#10937)
• Fix file persist retries on Windows (#11008)
• Fix incorrect error message when specifying tool.uv.sources.(package).workspace with other options (#11013)
• Improve SIGINT handling in uv run (#11009)

Documentation

• Add SECURITY policy (#11035)
• Add Requires-Python upper bound behavior to the docs (#10964)
• Add a troubleshooting section and reproducible example guide (#10947)
• Add documentation for uv add -r (#10926)
• Amend requires-python rules in resolver documentation (#10993)
• Reference workspaces in --no-sources documentation (#10995)
• Update documentation for activating virtual environments in different shell (#11000)
• Add Docker SHA pinning tip (#10955)

Install uv 0.5.25

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.25

File	Platform	Checksum
uv-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
uv-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
uv-aarch64-pc-windows-msvc.zip	ARM64 Windows	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

Release Notes

Enhancements

• Improve determinism of resolution by always setting package priorities (#10853)
• Upgrade to cargo-dist 0.28.0; improves several installer behaviors (#10884)

Performance

• Remove dependencies clone in resolver (#10880)
• Use Hashbrown's raw entry API to reduce hashes and clone in resolver priority determination (#10881)

Bug fixes

• Allow fallback to Python download on non-critical discovery errors (#10908)

Preview features

• Register managed Python version with the Windows Registry (PEP 514) (#10634)

Documentation

• Improve documentation for some environment variables (#10887)
• Add git subdirectory example (#10894)

Install uv 0.5.24

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.24

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

Release Notes

Enhancements

• Add --refresh to uv venv (#10834)
• Add --no-default-groups command-line flag (#10618)

Bug fixes

• Sort extras and groups when comparing lockfile requirements (#10856)
• Include commit_id and requested_revision in direct_url.json (#10862)
• Invalidate lockfile when static versions change (#10858)
• Make GitHub fast path errors non-fatal (#10859)
• Remove warnings for --frozen and --locked in uv run --script (#10840)
• Resolve find-links paths relative to the configuration file (#10827)
• Respect visitation order for proxy packages (#10833)
• Treat version mismatch errors as non-fatal in fast paths (#10860)
• Mark --locked and --upgrade are conflicting (#10836)
• Relax error checking around unconditional enabling of conflicting extras (#10875)

Documentation

• Reduce ambiguity in conflicting extras example (#10877)
• Update pre-commit documentation (#10756)

Error messages

• Error when workspace contains conflicting Python requirements (#10841)
• Improve uvx error message when uv is missing (#9745)

Install uv 0.5.23

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.23/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Enhancements

• Include version and contact information in GitHub User Agent (#10785)

Performance

• Add fast-path for recursive extras in dynamic validation (#10823)
• Fetch pyproject.toml from GitHub API (#10765)
• Remove allocation in Git SHA truncation (#10801)
• Skip GitHub fast path when full commit is already known (#10800)

Bug fixes

• Add fallback to build backend when Requires-Dist mismatches (#10797)
• Avoid deserialization error for paths above the root (#10789)
• Avoid respecting preferences from other indexes (#10782)
• Disable the distutils setuptools shim during interpreter query (#10819)
• Omit variant when detecting compatible Python installs (#10722)
• Remove TOCTOU errors in Git clone (#10758)
• Validate metadata under GitHub fast path (#10796)
• Include conflict markers in fork markers (#10818)

Error messages

• Add tag incompatibility hints to sync failures (#10739)
• Improve log when distutils is missing (#10713)
• Show non-critical Python discovery errors if no other interpreter is found (#10716)
• Use colors for lock errors (#10736)

Documentation

• Add testing instructions to the AWS Lambda guide (#10805)

Install uv 0.5.22

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.22/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Enhancements

• Avoid building dynamic versions when validating lockfile (#10703)

Configuration

• Add UV_VENV_SEED environment variable (#10715)

Performance

• Store unsupported tags in wheel filename (#10665)

Bug fixes

• Avoid attempting to patch macOS dylib for non-macOS installs (#10721)
• Avoid narrowing requires-python marker with disjunctions (#10704)
• Respect environment variable credentials for indexes outside root (#10688)
• Respect preferences for explicit index dependencies from requirements.txt (#10690)
• Sort preferences by environment, then index (#10700)
• Ignore permission errors when looking for user-level configuration file (#10697)

Documentation

• Add SyntaxWarning compatibility note to bytecode compilation docs (#10701)
• Add MACOSX_DEPLOYMENT_TARGET to the --python-platform documentation (#10698)

Install uv 0.5.21

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.21/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Bug fixes

• Avoid failing when deserializing unknown tags (#10655)

Install uv 0.5.20

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.20/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Enhancements

• Filter wheels from lockfile based on architecture (#10584)
• Omit dynamic versions from the lockfile (#10622)
• Add support for pip freeze --path (#10488)
• Reduce verbosity of inline-metadata message when using uv run <script.py> (#10588)
• Add opt-in Git LFS support (#10335)
• Recommend --native-tls on SSL errors (#10605)
• Show expected and available ABI tags in resolver errors (#10527)
• Show target Python version in error messages (#10582)
• Add --output-format=json support to uv python list (#10596)

Python

The managed Python distributions have been updated, including:

• Python 3.14 support on Windows
• Python 3.14.0a4 support
• 64-bit RISC-V Linux support
• Bundled libedit updated from 20210910-3.1 -> 20240808-3.1
• Bundled tcl/tk updated from 8.6.12 -> 8.6.14 (for all Python versions on Unix, only for Python 3.14 on Windows)

See the python-build-standalone release notes for more details.

Performance

• Avoid allocating when stripping source distribution extension (#10625)
• Reduce WheelFilename to 48 bytes (#10583)
• Reduce distribution size to 200 bytes (#10601)
• Remove import re from entrypoint wrapper scripts (#10627)
• Shrink size of platform tag enum (#10546)
• Use ArcStr in verbatim URL (#10600)
• Use memchr for wheel parsing (#10620)

Bug fixes

• Avoid reading symlinks during uv python install on Windows (#10639)
• Correct Pyston tag format (#10580)
• Provide pyproject.toml path for parse errors in uv venv (#10553)
• Don't treat setuptools and wheel as seed packages in uv sync on Python 3.12 (#10572)
• Fix git-tag cache-key reader in case of slashes (#10467) (#10500)
• Include build tag in rendered wheel filenames (#10599)
• Patch embedded install path for Python dylib on macOS during python install (#10629)
• Read cached registry distributions when --config-settings are present (#10578)
• Show resolver hints for packages with markers (#10607)

Documentation

• Add meta titles to documents in guides, excluding integration documents (#10539)
• Remove build-system from example workspace rot (#10636)

Preview features

• Make build backend type annotations more generic (#10549)

Install uv 0.5.19

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.19/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Bug fixes

• Avoid forking for identical markers (#10490)
• Avoid panic in uv remove when only comments exist (#10484)
• Revert "improve shell compatibility of venv activate scripts (#10397)" (#10497)

Install uv 0.5.18

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.18/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

This release includes support for generating lockfiles from scripts based on inline metadata, as defined in PEP 723.

By default, scripts remain unlocked, and must be locked explicitly with uv lock --script /path/to/script.py, which will generate a lockfile adjacent to the script (e.g., script.py.lock). Once generated, the lockfile will be respected (and updated, if necessary) across uv run --script, uv add --script, and uv remove --script invocations.

This release also includes support for uv export --script and uv tree --script. Both commands support PEP 723 scripts with and without accompanying lockfiles.

Enhancements

• Add support for locking PEP 723 scripts (#10135)
• Respect PEP 723 script lockfiles in uv run (#10136)
• Update PEP 723 lockfile in uv add --script (#10145)
• Update PEP 723 lockfile in uv remove --script (#10162)
• Add --script support to uv export for PEP 723 scripts (#10160)
• Add --script support to uv tree for PEP 723 scripts (#10159)
• Add ls alias to uv {tool, python, pip} list (#10240)
• Allow reading --with-requirements from stdin in uv add and uv run (#10447)
• Warn-and-ignore for unsupported requirements.txt options (#10420)

Preview features

• Add remaining Python type annotations to build backend (#10434)

Performance

• Avoid allocating for names in the PEP 508 parser (#10476)
• Fetch concurrently for non-first-match index strategies (#10432)
• Remove unnecessary .to_string() call (#10419)
• Respect sentinels in package prioritization (#10443)
• Use ArcStr for marker values (#10453)
• Use ArcStr for package, extra, and group names (#10475)
• Use matches! rather than contains in requirements.txt parsing (#10423)
• Use faster disjointness check for markers (#10439)
• Pre-compute PEP 508 markers from universal markers (#10472)

Bug fixes

• Fix UV_FIND_LINKS delimiter to split on commas (#10477)
• Improve uv tool list output when tool environment is broken (#10409)
• Only track markers for compatible versions (#10457)
• Respect requires-python when installing tools (#10401)
• Visit proxy packages eagerly (#10441)
• Improve shell compatibility of venv activate scripts (#10397)
• Read publish username from URL (#10469)

Documentation

• Add Lambda layer instructions to AWS Lambda guide (#10411)
• Add uv lock --script to the docs (#10414)
• Use Windows-specific instructions in Jupyter guide (#10446)

Install uv 0.5.17

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.17/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Enhancements

• Accept full requirements in uv remove (#10338)

Performance

• Avoid over-counting versions in batch prefetcher (#10350)
• Deactivate tracing for version-choosing (#10351)
• Force a niche into VersionSmall (#10385)
• Optimize requirements_for_extra (#10348)
• Re-enable zlib-ng on x86 platforms (#10365)
• Re-enable zlib-ng on all platforms (except s390x, PowerPC, and FreeBSD) (#10370)
• Remove [u64; 4] from small version to move Arc to full version (#10345)
• Shrink Dist from 352 to 288 bytes (#10389)
• Speed up file pins by removing nested hash map (#10346)
• Buffer file reads in serde_json::from_reader (#10341)

Bug fixes

• Avoid enforcing project-level required version for uv self (#10374)
• Fix Ruff linting warnings from generated template files for extension modules (#10371)

Documentation

• Add AWS Lambda integration guide (#10278)

Install uv 0.5.16

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.16/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Python

The managed Python distributions have been updated, including:

• Python 3.14.0a3 support on macOS and Linux
• Performance improvements
• Fixes to SQLite feature detection

See the python-build-standalone release notes for more details.

Enhancements

• Respect FORCE_COLOR environment variable (#10315)

Performance

• Avoid generating unused hashes during uv lock (#10307)
• Visit source distributions before wheels (#10291)

Bug fixes

• Avoid downgrading packages when --upgrade is provided (#10097)
• Extract supported architectures from wheel tags (#10179)
• Redact new index credentials in uv add (#10329)

Documentation

• Clarify exclude-newer only allows full timestamps in settings documentation (#9135)
• Tweak script --no-project comment (#10331)
• Update copyright year (#10297)
• Add instructinos for installing with Scoop (#10332)

Install uv 0.5.15

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.15/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Enhancements

• Add --exact flag to uv run (#10198)
• Add --outdated support to uv pip tree (#10199)
• Add a required version setting to uv (#10248)
• Add loongarch64 to supported Python platform tags (#10223)
• Add manylinux2014 aliases for --python-platform (#10217)
• Add support for Python interpreters on ARMv5TE platforms (#10234)
• Add support for optional --description in uv init (#10209)
• Ignore empty or missing hrefs in Simple HTML (#10276)
• Patch pkgconfig files after Python install (#10189)

Performance

• Actually use jemalloc as alternative allocator (#10269)
• Parse URLs lazily in resolver (#10259)
• Use BTreeMap::range to avoid iterating over unnecessary versions (#10266)

Bug fixes

• Accept directories with space names in uv init (#10246)
• Avoid forking on version in non-universal resolutions (#10274)
• Avoid stripping query parameters from URLs (#10253)
• Consider workspace dependencies to be 'direct' (#10197)
• Detect cyclic dependencies during builds (#10258)
• Guard against self-deletion in uv venv and uv tool (#10206)
• Respect static metadata for already-installed distributions (#10242)

Install uv 0.5.14

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.5.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.5.14/uv-installer.ps1 | iex"

Download uv 0.5.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

Release Notes

Bug fixes

• Avoid enforcing URL check on initial publish (#10182)
• Fix incorrect mismatched constraints reference (#10184)
• Revert "Update reqwest (#10178)" (#10187)

Install uv 0.5.13

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.13

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

Release Notes

Enhancements

• Support uv export for non-project workspaces (#10144)
• Set glibc versions for standalone installers (#10142)
• Allow environment variables to be included in cache keys (#10170)

Preview features

• Include extras in uv-build Requires-Dist metadata (#10110)
• Use shutil.which for the build backend (#10028)

Bug fixes

• Always write slash paths to RECORD file (#10164)
• Add support for subdirectories in direct URLs in uv.lock (#10068)
• Avoid duplicating backslashes in sysconfig parser (#10063)
• Avoid erroring when subdirectories are provided in uv add (#10095)
• Backtrack to non-local versions when wheels are missing platform support (#10046)
• Fix mirror script to handle newer metadata format (#10050)
• Preserve sort when deciding on requirement placement (#10078)
• Remove redundant alias in uv init CLI (#10124)
• Respect sources credentials in non-project workspaces (#10125)
• Show non-project dependencies in uv tree (#10149)
• Strip fragment when storing direct URL (#10093)
• Include hashes for local source archives (#10080)

Documentation

• Fix invalid syntax in some sources examples (#10127)

Install uv 0.5.12

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.12

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

Release Notes

Enhancements

• Normalize platform_system to sys_platform (#9949)
• Improve retry mechanisms on Windows for copy_atomic and write_atomic (#10026)
• Add nuance to prefetch logging (#9984)
• Update to python-build-standalone 20241219

Preview features

• Build backend: Preserve executable bits for scripts in distributions (#10027)
• Build backend: Handle case where metadata_directory already contains dist-info directory (#10005)

Performance

• Batch resolver pre-fetches per fork (#10029)

Bug fixes

• Allow --script to be provided with uv run - (#10035)
• Allow uv run arguments when reading from stdin (#10034)
• Prefer higher Python lower-bounds when forking (#10007)
• Remove references to deprecated first-match (#10036)

Documentation

• Add uv python install --preview to the documentation (#10010)
• Fix uv python install --default note about multiple requests (#10011)
• Fix typo in Caching docs (#10032)
• Remove remaining references to deprecated first-match (#10038)
• Supplement missing separators for UV_INSTALL_DIR directions on Windows (#9507)

Install uv 0.5.11

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.11

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

Release Notes

Enhancements

• Improve backtracking behavior when packages conflict repeatedly (#9843)
• Patch Python sysconfig values such as AR at ar install time (#9905)
• Patch Python sysconfig values such as clang to cc at install time (#9916)
• Skip --native-tls in pip compile header (#9913)
• Add resolver error hint for no-binary and no-build failures (#9948)
• Improve build error messages (#9660)
• Reduce redundant Python version incompatibilities in resolver error message (#9957)
• Reduce redundant enumeration of all package versions in some resolver errors (#9885)
• Improve display of ranges when pre-releases are not allowed (#9944)
• Improve error messages for uv remove (#9959)
• Improve phrasing for single term incompatibilities (#9953)
• Improve styling of uv remove dependency hints (#9960)
• Omit trailing zeros on Python requirements inferred from versions (#9952)
• Show a concise error message for missing version field (#9912)
• Use the build options value to improve hints for no wheel / source distribution errors (#9950)

Bug fixes

• Allow multiple disjoint URLs in overrides (#9893)
• Include explicit indexes in publish index choice (#9932)
• Fix Python interpreter detection for 32-bit operating systems on 64-bit hosts (#9970)

Documentation

• Fix typo "operation system" (#9971)
• Clarify uninstallation docs (#9938)
• Add a note to say that dependencies between workspace members are editable (#9363)
• Correctly document default value of fork-strategy setting (#9931)
• Use double quotes for Windows support in examples (#9946)
• Remove pypy from top-level pin example (#9896)
• Update references to python-build-standalone to reflect the transferred project (#9977)
• Use a different Ruff version in documentation (#9943)
• Change example so it works as-is on powershell and cmd.exe (#9903)
• Clarify best practice for Python matrix strategy in GitHub Actions (#9454)
• Add documentation for uv-lock and uv-export pre-commit hooks (#9872)

Preview features

• Build backend: Fix pre-PEP 639 license files (#9965)

Install uv 0.5.10

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.10

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

Release Notes

Enhancements

• Fork version selection based on requires-python requirements (#9827)
• Patch sysconfig data at install time (#9857)
• Remove -isysroot when patching sysconfig (#9860)

Configuration

• Introduce a --fork-strategy preference mode (#9868)
• Add support for UV_OFFLINE (#9795)

Bug fixes

• Avoid panic!() when current directory does not exist (#9876)
• Avoid reusing interpreter metadata when running under Rosetta (#9846)
• Avoid trailing slash when deserializing from lockfile (#9848)
• Fix bug in terms when collapsing unavailable versions in resolver errors (#9877)
• Fix suggestion to use uv help python on invalid install requests (#9820)
• Skip root when assessing prefix viability (#9823)
• Avoid spurious 'Upgraded tool environment' in uv tool upgrade (#9870)

Rust API

• Upgrade minimum Rust version to 1.83 (#9815)

Documentation

• Document the --fork-strategy setting (#9887)

Preview features

• Build backend: Allow underscores in entrypoints (#9825)

Install uv 0.5.9

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.9

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

Release Notes

This release does not include the powerpc64le-unknown-linux-musl target due to a build issue. See #9793 for details. If this change affects you, please file an issue with your use-case.

Enhancements

• Omit empty resolution markers in lockfile (#9738)
• Add --install-dir to to uv python install and uninstall commands (#7920)
• Add --show-urls and --only-downloads to uv python list (#8062)
• Add uv python list --all-arches (#9782)
• Add uv run --gui-script flag for running Python scripts with pythonw.exe (#9152)
• Allow --gui-script on Unix (#9787)
• Allow download of Python distribution variants optimized for newer x86_64 microarchitectures (#9781)
• Allow execution of pyw files on Unix (#9759)
• Allow users to specify URLs in project.dependencies and tool.uv.sources (#9718)
• Encode mutually-incompatible pairs of markers (#9444)
• Improve the error message when a Python install request is not valid (#9783)
• Preserve directory-level standalone build symlinks (#9723)
• Add support for uv publish --index <name> (#9694)
• Reframe --locked and --frozen as --check operations for uv lock (#9662)
• Rename Python install scratch directory from .cache -> .temp (#9756)
• Enable uv tool uninstall uv on Windows (#8963)
• Improve self-dependency hint to make shadowing clear (#9716)
• Refactor unavailable metadata to shrink the resolver (#9769)
• Show 'depends on itself' for proxy packages (#9717)
• Show a dedicated error for missing subdirectories (#9761)
• Show a dedicated hint for missing git+ prefixes (#9789)

Performance

• Eagerly error when parsing pyproject.toml requirements (#9704)
• Use copy-on-write when normalizing paths (#9710)

Bug fixes

• Avoid enforcing non-conflicts in uv export (#9751)
• Don't drop comments between items in TOML tables (#9784)
• Don't fail with --no-build when static metadata is available (#9785)
• Don't filter non-patch registry version (#9736)
• Don't read metadata from stale .egg-info files (#9760)
• Enforce correctness of self-dependencies (#9705)
• Fix projects's typo in resolver error messages (#9708)
• Ignore . prefixed directories during managed Python installation discovery (#9786)
• Improve handling of invalid virtual environments during interpreter discovery (#8086)
• Normalize relative paths when --project is specified (#9709)
• Respect self-constraints on recursive extras (#9714)
• Respect user settings for tracing coloring (#9733)
• Retry on tar extraction errors (#9753)
• Add conflict markers to the lock file (#9370)
• De-duplicate resolution markers (#9780)
• Avoid 403 error hint for PyTorch URLs (#9750)
• Avoid treating non-existent --find-links as relative URLs (#9720)
• Omit Windows Store python3.13.exe et al (#9679)
• Replace executables with broken symlinks during uv python install (#9706)

Documentation

• Fix build failure links (#9740)

Install uv 0.5.8

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.8

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

Release Notes

Enhancements

• Ignore dynamic version in source dist (#9549)
• Improve build frontend error handling (#9611)
• Un-hide uv build --no-build-logs option (#9642)
• Flag version mismatch between sdist and wheel during uv build (#9633)
• Improve message when updater receipt is for a different uv executable (#9487)
• Add environment variable to disable writing installer metadata files (#8877)
• Add managed downloads for the latest CPython releases: 3.9.21, 3.10.16, 3.11.11, 3.12.8, and 3.13.1 (#9696)

Preview features

• Build backend: Add hint on import with preview disabled (#9691)
• Build backend: Add direct builds to the resolver and installer (#9621)
• Build backend: Add integration test for scripts (#9635)
• Build backend: Add template to uv init (#9661)
• Build backend: Add --list option (#9610)

Bug fixes

• Create missing parent directories for output file of uv export / uv pip compile (#9648)
• Fix missing display of non-freethreaded Python 3.13 in python list (#9669)
• Implement Ord and PartialOrd without origin for Requirement (#9624)
• Include more sources to avoid lowest bound warning (#9644)
• Respect build tag priority in uv.lock (#9677)

Documentation

• Add build-essentials note to build failures doc (#9641)
• Add entry-point for distroless image in GitLab documentation (#9093)
• Add documentation for uv python pin without a REQUEST argument (#9631)
• Add a link to uv python pin reference docs (#9630)

Install uv 0.5.7

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.7

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

Release Notes

Enhancements

• Add --dry-run to uv pip uninstall (#9557)
• Allow --constraints and --overrides in uv tool install (#9547)
• Display removed Python executables on uninstall (#9459)
• Warn when keyring has no password for uv publish (#8827)
• Add suggested action when .python-version pin is incompatible with the project (#9590)
• Improve error messages for mismatches in tool.uv.sources (#9482)
• Use constraints in trace rather than irrelevant requires-python (#9529)

Preview features

• Add uv python install --default (#8650)
• Fix Python executable installation when multiple patch versions are requested (#9607)
• Build backend: Revamp include / exclude (#9525)
• Build backend: Add fast path (#9556)
• Build backend: Add functions to collect file list (#9602)
• Build backend: Default excludes (#9552)
• Build backend: Refactoring before list (#9558)
• Build backend: Warn when visiting over 10k files (#9523)

Configuration

• Make check-url available in configuration files (#9032)

Performance

• Avoid adding non-extra package with extra dependencies (#9540)
• Avoid cloning String in marker evaluation (#9598)

Rust API

• uv-pep508: Add more methods for simplifying extra-related expressions (#9469)

Bug fixes

• Allow file: URLs to include package names (#9493)
• Avoid using IDs across PubGrub states (#9538)
• Consistently enforce requested-vs.-built metadata when retrieving wheels (#9484)
• Do not show empty version specifier in uv tool list (#9605)
• Include Git member information when getting metadata from cache (#9388)
• Include base installation directory in uv run PATH (#9585)
• Insert backslash when appending to system drive (#9488)
• Normalize paths when lowering Git dependencies (#9595)
• Omit origin when comparing requirements (#9570)
• Override manylinux_compatible with --python-platform (#9526)
• Pass extra when evaluating lockfile markers (#9539)
• Propagate markers for recursive extras in resolver (#9509)
• Respect path dependencies within Git dependencies (#9594)
• Support recursive extras with marker in pip compile -r pyproject.toml (#9535)
• Don't emit unpinned warning for proxy packages (#9497)
• Fix --refresh-package flag mentioned as --refresh-dependency (#9486)
• Handle Windows AV/EDR file locks during script installations (#9543)
• Re-enable conflicting extra/group tests and fix regression from #9540 (#9582)

Documentation

• Add missing word to docs for run.md (#9527)
• Add policies reference section and license document (#9367)
• Fix typo in entry point docs (#9491)
• Fix up version in prior uninstall instructions (#9485)
• Mention uv pip behavior in build system note (#9586)
• Update build failures document (#9584)
• Correct wording for multiple sources section (#9504)

Install uv 0.5.6

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.6

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

Release Notes

Enhancements

• Add aliases for build backend requests (#9294)
• Avoid displaying empty paths (#9312)
• Allow constraints in uv tool upgrade (#9375)
• Remove conflict between --no-sync and --frozen in uv run (#9400)
• Respect dependency sources in overrides and constraints (#9455)
• Show an interpreter-focused message for --target and --prefix (#9373)
• Add --no-extra flag and setting (#9387)
• Add uv export --prune (#9389)
• Add dedicated error message for musl install attempts (#9430)
• Add various grammar changes to conflict error messages (#9369)
• Annotate default groups in conflict error messages (#9368)
• Report marker diagnostics during parsing, rather than evaluation (#9338)
• Use consistent formatting for build system errors (#9340)
• Use rich diagnostics for build failures (#9335)

Preview features

• Improve build backend excludes (#9281)
• Include PEP 639 license-files metadata during uv publish (#9442)

Performance

• Initialize rayon lazily (#9435)
• Migrate to PubGrub's arena for package names (#9448)

Bug fixes

• Allow dependency groups to include the containing package (#9385)
• Allow syncing to empty virtual environment directories (#9427)
• Allow system Python discovery with --target and --prefix (#9371)
• Don't warn when --output-file is empty (#9417)
• Fix Python interpreter discovery on non-glibc hosts (#9005)
• Fix tool.uv.dependency-metadata.[].version schema (#9468)
• Only respect preferences across the same indexes (#9302)
• Re-compile when --compile is passed to an install operation (#9378)
• Remove --upgrade, --no-upgrade, and --upgrade-package from uv tool upgrade (#9318)
• Remove dev dependencies in --all-groups --no-dev (#9300)
• Surface extras and group conflicts in uv export (#9365)
• Treat deprecated aliases as equivalent in marker algebra (#9342)
• Treat less compatible tags as lower priority in resolver (#9339)

Documentation

• Avoid referencing scikit-build (instead of scikit-build-core) (#9320)
• Expand entry points documentation (#9329)
• Fix example pyproject.toml in project concept documentation (#9298)
• Fix header level of "Conflicting dependencies" page (#9330)
• Touch-up the extension module guide (#9293)
• Update the dependencies documentation (#9359)
• Reference --no-progress option in related environment variable (#9357)

Install uv 0.5.5

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.5

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

Release Notes

Enhancements

• Accept either singular or plural values for CLI requirements (#9196)
• Add --all-groups to uv sync, uv run, uv export, and uv tree (#8892)
• Add a progress bar to uv tree --outdated and uv pip list --outdated (#9284)
• Add retries for Python downloads (#9274)
• Use exponential backoff for publish retries (#9276)
• Add manylinux target triples up to glibc 2.40 (#9234)

Performance

• Parallelize network requests in uv tree --outdated (#9280)
• Use zlib-rs on all platforms (#9264)

Bug fixes

• Avoid validating extra and group sources in build-system.requires (#9273)
• Catch retries with wrapped reqwest errors (#9253)
• Sort hashes in uv export output (#9237)
• Strip --index and --default-index from command header (#9288)

Documentation

• Add breadcrumbs to the documentation (#9242)
• Add minimum version to PyTorch guide (#9247)
• Add support for anchor redirects with client-side js (#9212)
• Improve content on project configuration (#9235)
• Improve the project creation documentation (#9236)
• Move the integration guides into the "Guides" section as a collapsed group (#9245)
• Reorganize the project concept documentation (#9121)
• Use the full screen height for the main content to stabilize the nav (#9153)

Error messages

• Add dedicated warning for empty stdin (#9256)

Install uv 0.5.4

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.4

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

Release Notes

This release includes support for conflicting optional dependencies and dependency groups in the uv resolver, including the ability to specify dependency sources (like index assignment) on a per-extra or per-group basis.

For example, you can now select CPU-only vs. GPU-enabled PyTorch builds at runtime by defining conflicting extras in a pyproject.toml, and assigning different extras to different PyTorch indexes:

[project]
name = "project"
version = "0.1.0"
requires-python = ">=3.12.0"

[project.optional-dependencies]
# Include `torch` whenever `--extra cpu` or `--extra gpu` is provided.
cpu = ["torch>=2.5.1"]
gpu = ["torch>=2.5.1"]

[tool.uv]
# But allow `cpu` and `gpu` to choose conflicting versions of `torch`.
conflicts = [[{ extra = "cpu" }, { extra = "gpu" }]]

[tool.uv.sources]
torch = [
  # With `--extra cpu`, pull PyTorch from the CPU-only index.
  { index = "pytorch-cpu", extra = "cpu", marker = "platform_system != 'Darwin'" },
  # With `--extra gpu`, pull PyTorch from the GPU-enabled index.
  { index = "pytorch-gpu", extra = "gpu" },
]

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

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

See the PyTorch documentation for more.

Enhancements

• Allow conflicting extras in explicit index assignments (#9160)
• Support overrides and constraints in PEP 723 scripts (#9162)
• Update uv tool install --force to imply --reinstall-package <name> (#9074)
• Turn --verify-hashes on by default (#9170)

Performance

• Enable zlib-rs on all platforms (#9202)

Bug fixes

• Allow apostrophe in virtual environment name (#8984)
• Automatically retry body errors when processing response (#9213)
• Detect nested workspace inside the current workspace and members with identical names (#9094)
• Only install the specified project with --frozen --package in legacy non-[project] workspaces (#9215)
• Respect [[tool.uv.index]] in PEP 723 scripts (#9208)
• Show derivation markers for resolutions with project name (#9136)
• Sort distributions when computing hash (#9185)
• Include trampolines in source distributions on Windows (#9172)

Documentation

• Add --index <name>=<url> syntax to index documentation (#9139)
• Add documentation for using uv with PyTorch (#9210)

Error messages

• Add a dedicated error for include = "dev" with tool.uv.dev-dependencies (#9173)
• Avoid showing disjoint marker error with true (#9169)
• Improve error message when git is not found (#9206)
• Include extras and dependency groups in derivation chains (#9113)
• Include version constraints in derivation chains (#9112)

Install uv 0.5.3

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.3

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

Release Notes

Enhancements

• Hide --no-system from uv pip tree CLI (#9040)
• Allow configuration of Python and PyPy install mirrors in uv.toml (#8695)
• Allow passing Python download mirrors to uv python install (#8695)
• Add support for specifying conflicting extras and dependency groups (#8976, #9096)
• Consistent colon usage in build failure errors (#8994)
• Show full derivation chain when encountering build failures (#9108)
• Show link we failed on parsing index pages (#9118)
• Remove duplicate log when searching for interpreters (#9092)
• Update uv development status classifier to "Stable" on PyPI (#8943)
• Use rich diagnostic formatting for early build failures (#9041)
• Use rich diagnostic formatting for install failures (#9043)

Performance

• Avoid retraversing filesystem when testing exact glob matches (#9022)

Bug fixes

• Allow --no-build to validate lock (#9024)
• Allow default indexes to be marked as explicit (#8990)
• Avoid creating .venv in uv add --frozen and uv add --no-sync (#8980)
• Avoid duplicating first-entry comments in uv add (#9109)
• Defer reporting of build failures in resolver (#9098)
• Fix references to --resolution-strategy in error message output (#8971)
• Ignore virtual environments in parent directories when choosing Python version for new projects (#9075)
• Forward SIGTERM to child processes in uv run (#8933)
• Prefer Python executable names that match the request over default names (#9066)
• Prefer compatible to incompatible distributions when packages exist on multiple indexes (#8961)
• Publish: Ignore non-matching files (#8986)
• Revert uv.lock changes when uv add fails (#9030)
• Show file extensions on available commands when not .exe (#9099)
• Sort by name, then specifiers in uv add (#9097)
• Split after specifiers in --with requirements (#9089)
• Support multiple extras in universal pip compile output (#8960)

Preview features

• Build backend: Add tests for source tree -> source dist -> wheel conversions (#9091)
• Build backend: Switch to custom glob-walkdir implementation (#9013)
• Build backend: Add minimal wheel settings (#9085)

Documentation

• Add wget instructions for systems without curl (#8630)
• Fix .env file example in docs (#9064)
• Fix reference to --resolution in docs (#8968)
• Fix typo in GitLab integration docs (#9047)
• Update format of environment variable reference (#9018)
• Use Python syntax for value_type consistently (#9017)
• Use [[index]] API in configuration example (#9065)
• Mention how to use extras (#8972)
• Add some words about specifying conflicting extras/groups (#9120)

Install uv 0.5.2

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.2

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

Release Notes

Enhancements

• Allow installation of manylinux wheels on riscv64 (#8934)

Bug fixes

• Build source distributions at top-level of cache (#8905)
• Allow non-registry dependencies in uv pip list --outdated (#8939)
• Compute superset of existing and required hashes when healing cache (#8955)
• Enable uv to replace and delete itself on Windows (#8914)
• Remove source distribution filename from cache (#8907)
• Respect --index-url in uv pip list (#8942)
• Respect comma-separated extras in --with (#8946)

Documentation

• Add uninstall note for previous versions (#8937)
• Remove some missed references to ~/.cargo/bin (#8936)
• Split README's install code block into 3 (#8853)

Install uv 0.5.1

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.1

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

Release Notes

Since the launch of Python version, project, and tool management capabilities back in August, we've seen extraordinary adoption of uv. We've been iterating rapidly: adding new features, fixing bugs, and improving the user experience. Despite moving quickly, stability and compatibility have been a major focus — we've made thirty releases since our last breaking change. Consequently, we've accumulated various changes that improve correctness and user experience, but could break some workflows. This release contains those changes; many have been marked as breaking out of an abundance of caution. We expect most users to be able to upgrade without making changes.

Breaking changes

• Use base executable to set virtualenv Python path (#8481)

  Previously, uv canonicalized the path to the Python executable when setting the Python path in created virtual environments. This behavior had several undesirable effects: it would bypass stabilized version directories (as constructed by Homebrew) and it was not consistent with the Python standard library's behavior. Now, uv uses the sys._base_executable path.

• Use XDG (i.e. ~/.local/bin) instead of the Cargo home directory in the installer (#8420)

  Previously, uv's installer used $CARGO_HOME or ~/.cargo/bin for its target install directory. It's been a longstanding complaint that uv uses this directory, as there's no relationship to Cargo. Now, uv will be installed into $XDG_BIN_HOME, $XDG_DATA_HOME/../bin, or ~/.local/bin (in that order). Note that $UV_INSTALL_DIR can always be used to override the target directory. Upgrading with uv self update will not move uv to the new install directory.

• Discover and respect .python-version files in parent directories (#6370)

  Previously, uv only read .python-version files from the working directory. Now, uv will check parent directories for .python-version files; however uv will not search for .python-version files beyond project boundaries. The new behavior is better aligned with that of pyenv and Rye.

• Error when disallowed settings are defined in uv.toml (#8550)

  Some settings can only be defined in the pyproject.toml. Previously, uv would ignore these settings when present in the uv.toml. Now, uv will error to avoid confusion about why the settings are not respected.

• Implement PEP 440-compliant local version semantics (#8797)

  Previously, uv's implementation of local versions (e.g. 2.0+cpu) was not compliant with the specification due to the technical complexity of implementing the local version semantics in the PubGrub algorithm. Thanks to the work of @ericmarkmartin, uv now has a spec-compliant implementation. Namely, uv will now allow a request for torch==2.1.0 to install torch@2.1.0+cpu regardless of whether torch@2.1.0 (without a local tag) actually exists.

• Treat the base Conda environment as a system environment (#7691)

  Previously, uv would not distinguish between the base and other Conda environments. Now, uv uses CONDA_DEFAULT_ENV and the names base and default to determine if an environment active via CONDA_PREFIX is the base environment. If the base environment is active, the --system flag must be used to mutate it.

• Do not allow pre-releases when the != operator is used (#7974)

  Previously, uv would use the presence of a pre-release specifier in a version specifier as an opt-in to allow pre-release versions during resolution. The new behavior does not allow pre-releases when an inequals operator is used, e.g., != 2.0a1.

• Prefer USERPROFILE over FOLDERID_Profile when selecting a home directory on Windows (#8048)

  This change is a side-effect of switching from the directories crate to etcetera for determining canonical system paths. If USERPROFILE is not set, the behavior will be unchanged.

• Improve interactions between color environment variables and CLI options (#8215)

  Previously, uv would respect the FORCE_COLOR and NO_COLOR environment variables over the --color flag. Now, when the --color flag is explicitly provided, uv will respect it over the environment variables.

• Make allow-insecure-host a global option (#8476)

  Previously, this option was only available in some parts of uv. Now, --allow-insecure-host can be provided to any command. For consistency, the allow-insecure-host setting has been removed from the [tool.uv.pip] configuration in favor of [tool.uv].

• Only write .python-version files during uv init for workspace members if the version differs (#8897)

  Previously, uv would create a .python-version file for workspace members during uv init. Now, uv will only do so if the version differs from the .python-version file in the workspace root since uv will respect .python-version files in parent directories.

Enhancements

• Add uv tree --outdated (#8893)
• Add armv8l alias for armv7l to support arm 32-bit compatibility mode (#8881)
• Add support for pip list --outdated (#8872)
• Allow semicolons directly after direct URLs (#8836)
• Enable support for arbitrary git transports (#8769)
• Improve Python discovery source messages (#8890)
• Show dedicated error for trailing ; on URL and path requirements (#8835)
• Add progress bar for uv cache clean (#8857)
• Warn on failure to query system configuration file (#8829)

Preview features

• Add support for building basic source distributions with the experimental uv build backend (#8886)

Bug fixes

• Respect dynamic version updates in uv lock (#8867)
• Respect fork markers in --resolution-mode=lowest-direct (#8839)

Documentation

• Add further examples of git+https support (#8841)
• Add installer variables to environment reference (#8874)
• Add note on private classifier (#8783)
• Update pip-and-uv strictness example (#8822)
• Fix uv python install docs to use an existing PyPy version (#8845)
• Document how to mimic --verbose with RUST_LOG (#8858)

Install uv 0.5.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.5.0

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

Release Notes

Enhancements

• Add support for .env and custom env files in uv run (#8811)
• Add support for --all-packages in uv run, uv sync, and uv export (#8742, #8741, #8739)
• Allow use of --frozen with --all-packages in uv sync and uv export (#8760)
• Show full error chain on tool upgrade failures (#8753)
• Add --check-url to uv publish to check for existing distributions during upload (#8531)
• Suggest using --check-url when --skip-existing is used (#8803)

Bug fixes

• Allow incompatible requires-python for source distributions with static metadata (#8768)
• Allow managed downloads with --python-preference system (#8808)
• Avoid error for --group defined in non-root workspace member (#8734)
• Avoid showing dependency group annotations on workspace members in tree (#8730)
• Do not error when the Python bin directory is missing on uv python uninstall (#8725)
• Include member groups when locking workspace (#8736)
• Fix bug where python_version < '0' could appear in a final resolution (#8759)
• Sanitize filenames during zip extraction (#8732)
• Switch to RFC 9110 compatible format for exclude newer requests (#8752)

Preview features

• Add support for installing versioned Python executables on Windows (#8663)
• Improve interactions with existing Python executables during install (#8733)

Rust API

• Extend BaseClient to accept extra middleware (#8807)
• Add From for FlatDistributions struct (#8800)

Documentation

• Fix environment variable name in providing credentials section (#8740)
• Fix add httpx example with real git branch (#8756)
• Fix indentation in projects.md (#8772)
• Fix link to publish guide in README (#8720)
• Generate environment variables documentation from code (#8493)
• Improve and fix some documents (#8749)
• Improve environment variables document (#8777)

Install uv 0.4.30

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.4.30/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.30/uv-installer.ps1 | iex"

Download uv 0.4.30

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

Release Notes

Enhancements

• Sort errors during display in uv python install (#8684)
• Update resolver to use disjointness checks instead of marker equality (#8661)
• Add riscv64 to supported Python platform tags (#8660)

Bug fixes

• Fix hard and soft float libc detection for managed Python distributions on ARM (#8498)
• Handle cycles in uv pip tree (#8689)
• Respect dependency group markers in uv export (#8659)
• Support transitive dependencies in Git workspaces (#8665)
• Use portable paths for subdirectories in lock URLs (#8707)
• Update uv init --virtual to imply --no-package (#8595)

Preview

• Install versioned Python executables into the bin directory during uv python install (Unix only) (#8458)

Documentation

• Clarify relationship between specifiers and requires-python range (#8688)
• Fix broken link in docs (#8552)
• Fix outdated documentation on Requires-Python (#8679)
• Add Google Artifact Registry index authentication guide (#8579)

Install uv 0.4.29

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.4.29/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.29/uv-installer.ps1 | iex"

Download uv 0.4.29

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

Release Notes

Enhancements

• Add support for requesting free-threaded builds via +freethreaded (#8645)
• Improve trusted publishing error messages (#8633)
• Remove unneeded return from Maturin project template (#8604)
• Skip Python interpreter discovery for uv export (#8638)
• Hint about missing trusted publishing permission (#8632)

Configuration

• Add environment variable to disable progress output (#8600)

Bug fixes

• Fork when minimum Python version increases (#8628)
• Ignore empty groups when validating lock (#8598)
• Remove duplicate word in error message (#8589)
• Support cyclic dependencies in uv tree (#8564)
• Update uv init to imply --package when using --build-backend (#8593)
• Restore use of dev-dependencies and requires-dev for lockfile compatibility (#8599)

Documentation

• Clarify requires-python requirement for dependencies (#8619)
• Update CLI documentation for --cache-dir (#8627)

Install uv 0.4.28

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.4.28/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.28/uv-installer.ps1 | iex"

Download uv 0.4.28

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

Release Notes

This release includes support for the [dependency-groups] table as recently standardized in PEP 735. The table allows for declaration of optional dependency groups that are not published as part of the package metadata, unlike [project.optional-dependencies]. There are new --group, --only-group, and --no-group options throughout the uv interface.

Previously, uv used a single tool.uv.dev-dependencies list for declaration of development dependencies. Now, uv supports declaring development dependencies in a standardized format and allows splitting development dependencies into multiple groups.

For compatibility, and to simplify usage for people that do not need multiple groups, uv special-cases the group named dev. The dev group is equivalent to tool.uv.dev-dependencies. The contents of tool.uv.dev-dependencies will merged into the dev group in uv's resolver. The --dev, --only-dev, and --no-dev flags remain as aliases for the corresponding --group options. Support for tool.uv.dev-dependencies remains in this release, but will display warnings in a future release.

uv syncs the dev group by default — this matches the exististing behavior for tool.uv.dev-dependencies. The default groups can be changed with the tool.uv.default-groups setting.

Thank you to Stephen Rosen who authored PEP 735.

Enhancements

• Support for PEP 735 (#8272)
• Add support for --dry-run mode in uv lock (#7783)
• Don't allow non-string email in authors (#8520)
• Enforce lockfile schema versions (#8509)

Bug fixes

• Always attach URL to network errors (#8444)
• Fix dangling non-platform dependencies in uv tree (#8532)
• Prefer lto over debug free-threaded managed Python builds (#8515)

Documentation

• Add tool.uv.sources to the "Settings" reference (#8543)
• Add reference to uv build and uv publish in the landing pages (#8542)
• Avoid duplicate [tool.uv] header in TOML examples (#8545)
• Document .netrc environment variable and path (#8511)
• Fix .netrc typo in authentication docs (#8521)
• Fix heading level of "Script support" on docs landing page (#8544)
• Move the installation configuration docs to a separate page (#8546)
• Update docs for --publish-url to avoid duplication. (#8561)
• Fix typo (#8554)
• Fix typo in description of --strict flag (#8513)

Install uv 0.4.27

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.4.27/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.27/uv-installer.ps1 | iex"

Download uv 0.4.27

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

Release Notes

Enhancements

• Allow static dependency metadata entries for direct URL requirements (#7846)
• Use reinstall report formatting for uv python install --reinstall (#8487)
• Add support for system-level uv.toml configuration (#7851)

Bug fixes

• Apply requires-python narrowing with upper bounds (#8403)
• Avoid rewriting [[tool.uv.index]] entries when credentials are provided (#8502)
• Fix uv add comment handling for empty arrays (#8504)
• Replace dashes with underscores in index credential variables (#8452)
• Respect --allow-insecure-host in uv publish (#8440)
• Allow arbitrary --package includes in uv tree (#8507)
• Remove existing Python install after successful download in uv python install (#8485)

Documentation

• Add docs example for URLs with [tool.uv.dependency-metadata] (#8484)
• Add help page for build failures (#8286)
• Fix cache-keys typo in tags = true (#8422)
• Add documentation examples for manual branch, rev, and tag Git dependencies (#8497)

Error messages

• Improve error message for cache info serialization (#8500)
• Suggest --from command when executable is available for uvx (#8473)
• Support --with-editable in uv tool install (#8472)

Install uv 0.4.26

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.4.26/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.26/uv-installer.ps1 | iex"

Download uv 0.4.26

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

Release Notes

Enhancements

• Add support for uv pip show --files (#8369)
• Don't prefetch unreachable packages (#8246)
• Remove tool.uv.sources table if it is empty (#8365)
• Modify cache versioning to support backwards compatibility (#8386)

Configuration

• Add support for UV_FROZEN and UV_LOCKED (#8340)

Bug fixes

• Allow dashes and underscores in custom index names (#8339)
• Avoid panic when Git dependencies are included in fork markers (#8388)
• Check existing source by normalized name before uv add and uv remove (#8359)
• Fix bug where username from authentication cache could be ignored (#8345)
• Fix to respect comments positioning in pyproject.toml on change (#8384)
• Redact index sources in uv.lock (#8333)
• Use correct indentation when project table contains open bracket comment (#8387)
• Only remove a source from [tool.uv.sources] if it is no long being referenced (#8366)
• Modify uv pip list and uv tree to print to stdout regardless of --quiet flag (#8392)

Error messages

• Improve help message for missing self update invocations (#8337)
• Log .netrc parsing errors (#8364)
• Remove trailing newlines in error messages (#8322)
• Use a dedicated message for incompatible Python versions in wheel ABI tags (#8363)
• Remove commands available in the top-level from the suggested subcommand error (#8316)

Release

• Run release builds for macos-x86_64 on macos-14 runners (#8327)

Install uv 0.4.25

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.4.25/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.25/uv-installer.ps1 | iex"

Download uv 0.4.25

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

Release Notes

Bug fixes

• Fix Python executable name in Windows free-threaded Python distributions (#8310)
• Redact index credentials from lockfile sources (#8307)
• Respect UV_INDEX_ rather than UV_HTTP_BASIC_ as documented (#8306)
• Improve sources deserialization errors (#8308)

Documentation

• Correct pytorch-to-torch reference in docs (#8291)

Install uv 0.4.24

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.4.24/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.24/uv-installer.ps1 | iex"

Download uv 0.4.24

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

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.<minor> 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

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

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

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

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

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