0.5.11

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

0.5.10

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

0.5.9

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

0.5.8

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

0.5.7

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

0.5.6

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

0.5.5

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

0.5.4

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

0.5.3

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

0.5.2

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