Release Notes

Released on 2026-01-09.

Bug fixes

• Fix handling of UV_NO_SYNC=1 uv run ... (#17391)
• Rebuild dynamic distribution when version changes with --no-cache (#17387)

Documentation

• Add Rust language classifier (#17389)

Install uv 0.9.24

Install prebuilt binaries via shell script

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

Download uv 0.9.24

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-01-09.

Enhancements

• Only write portable paths in RECORD files (#17339)
• Support relative paths in UV_PYTHON_BIN_DIR and UV_TOOL_BIN_DIR (#17367)

Preview features

• Enable uploads to S3 via pre-signed URLs (#17349)

Configuration

• Allow setting proxy variables via global / user configuration (#16918)
• Manually parse and reconcile Boolean environment variables (#17321)

Bug fixes

• Avoid broken build artifacts on build failure (#17276)
• Fix missing dependencies on synthetic root in SBOM export (#17363)
• Recognize armv8l as an alias for armv7l in platform tag parsing (#17384)
• Fix redaction of a URL in a middleware trace log (#17346)

Documentation

• Add index.md suggestion to llms.txt (#17362)
• Clarify that uv run uses inexact syncing by default (#17366)

Install uv 0.9.23

Install prebuilt binaries via shell script

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

Download uv 0.9.23

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-01-06.

Enhancements

• Use a dedicated error message when lockfile can't be found (#17318)

Bug fixes

• Filter unusable wheels from the lockfile for more architectures (#17317)
• Correctly count retries originating from early middleware errors (#17274)

Documentation

• Clarify requirements file format in docs (#17284)

Install uv 0.9.22

Install prebuilt binaries via shell script

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

Download uv 0.9.22

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2025-12-30.

Bug fixes

• Fix regression where zstd distribution hashes were not considered valid (#17265)

Documentation

• Fix a typo in the resolution documentation (#17258)
• Fix a typo in python install --default documentation (#9826)

Install uv 0.9.21

Install prebuilt binaries via shell script

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

Download uv 0.9.21

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2025-12-29.

The 0.9.19 release failed to publish to crates.io and GitHub Releases, but was successfully published to PyPI, the GitHub Container Registry, and DockerHub. This is a re-release of 0.9.19, with the internal crate versions incremented to resolve the crates.io publish failure. The changelog entries for 0.9.19 are reproduced here.

Python

• Add CPython 3.15.0a3 (#17165)

Enhancements

• Allow uv pip compile to install missing python interpreters in cases where it would otherwise fail (#17216)
• Avoid creating file contents with uv init --bare --script (#17162)
• Respect --torch-backend in uv tool commands (#17117)
• Support comma-separated values in --no-binary and --only-binary (#17185)

Preview features

• Summarize package changes in uv sync with JSON output format (#16981)

Performance

• Avoid two hot String allocations in deserialization (#17221)
• Cache NVIDIA-hosted wheels by default (#17164)

Bug fixes

• Avoid enforcing incorrect hash in mixed-hash settings (#17157)
• Fix retry counts in cached client (#17104)
• Respect UV_PYTHON_DOWNLOAD_MIRROR in uv python list (#16673)
• Support remote pylock.toml files (#17119)
• Avoid flagging proxied Git URLs as ambiguous authority (#17234)
• Fix dropped support of - in pip constraints, overrides, and excludes (#17188)

Install uv 0.9.20

Install prebuilt binaries via shell script

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

Download uv 0.9.20

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2025-12-16.

Enhancements

• Add value hints to command line arguments to improve shell completion accuracy (#17080)
• Improve error handling in uv publish (#17096)
• Improve rendering of multiline error messages (#17132)
• Support redirects in uv publish (#17130)
• Include Docker images with the alpine version, e.g., python3.x-alpine3.23 (#17100)

Configuration

• Accept --torch-backend in [tool.uv] (#17116)

Performance

• Speed up uv cache size (#17015)
• Initialize S3 signer once (#17092)

Bug fixes

• Avoid panics due to reads on failed requests (#17098)
• Enforce latest-version in @latest requests (#17114)
• Explicitly set EntryType for file entries in tar (#17043)
• Ignore pyproject.toml index username in lockfile comparison (#16995)
• Relax error when using uv add with UV_GIT_LFS set (#17127)
• Support file locks on ExFAT on macOS (#17115)
• Change schema for exclude-newer into optional string (#17121)

Documentation

• Drop arm musl caveat from Docker documentation (#17111)
• Fix version reference in resolver example (#17085)
• Better documentation for exclude-newer* (#17079)

Install uv 0.9.18

Install prebuilt binaries via shell script

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

Download uv 0.9.18

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2025-12-09.

Enhancements

• Add torch-tensorrt and torchao to the PyTorch list (#17053)
• Add hint for misplaced --verbose in uv tool run (#17020)
• Add support for relative durations in exclude-newer (a.k.a., dependency cooldowns) (#16814)
• Add support for relocatable nushell activation script (#17036)

Bug fixes

• Respect dropped (but explicit) indexes in dependency groups (#17012)

Documentation

• Improve source-exclude reference docs (#16832)
• Recommend UV_NO_DEV in Docker installs (#17030)
• Update UV_VERSION in docs for GitLab CI/CD (#17040)

Install uv 0.9.17

Install prebuilt binaries via shell script

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

Download uv 0.9.17

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2025-12-06.

Python

• Add CPython 3.14.2
• Add CPython 3.13.11

Enhancements

• Add a 5m default timeout to acquiring file locks to fail faster on deadlock (#16342)
• Add a stub debug subcommand to uv pip announcing its intentional absence (#16966)
• Add bounds in uv add --script (#16954)
• Add brew specific message for uv self update (#16838)
• Error when built wheel is for the wrong platform (#16074)
• Filter wheels from PEP 751 files based on --no-binary et al in uv pip compile (#16956)
• Support --target and --prefix in uv pip list, uv pip freeze, and uv pip show (#16955)
• Tweak language for build backend validation errors (#16720)
• Use explicit credentials cache instead of global static (#16768)
• Enable SIMD in HTML parsing (#17010)

Preview features

• Fix missing preview warning in uv workspace metadata (#16988)
• Add a uv auth helper --protocol bazel command (#16886)

Bug fixes

• Fix Pyston wheel compatibility tags (#16972)
• Allow redundant entries in tool.uv.build-backend.module-name but emit warnings (#16928)
• Fix infinite loop in non-attribute re-treats during HTML parsing (#17010)

Documentation

• Clarify --project flag help text to indicate project discovery (#16965)
• Regenerate the crates.io READMEs on release (#16992)
• Update Docker integration guide to prefer COPY over ADD for simple cases (#16883)
• Update PyTorch documentation to include information about supporting CUDA 13.0.x (#16957)
• Update the versioning policy (#16710)
• Upgrade PyTorch documentation to latest versions (#16970)

Install uv 0.9.16

Install prebuilt binaries via shell script

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

Download uv 0.9.16

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2025-12-02.

Continuing the unfortunate chain of disrupted releases, this release failed due to an error publishing new PEP 740 attestations to PyPI. The release workflow was re-run after removing the PEP 740 attestations (see #16944) and our GitHub and PyPI artifacts were published as normal, but the crates.io publish completed in the first run and does not match the 0.9.15 tag — instead, the crates were published at commit e7af583. The only difference is the inclusion of #16885.

Python

• Add CPython 3.14.1
• Add CPython 3.13.10

Enhancements

• Add ROCm 6.4 to --torch-backend=auto (#16919)
• Add a Windows manifest to uv binaries (#16894)
• Add LFS toggle to Git sources (#16143)
• Cache source reads during resolution (#16888)
• Allow reading requirements from scripts without an extension (#16923)
• Allow reading requirements from scripts with HTTP(S) paths (#16891)

Configuration

• Add UV_HIDE_BUILD_OUTPUT to omit build logs (#16885)

Bug fixes

• Fix uv-trampoline-builder builds from crates.io by moving bundled executables (#16922)
• Respect NO_COLOR and always show the command as a header when paging uv help output (#16908)
• Use 0o666 permissions for flock files instead of 0o777 (#16845)
• Revert "Bump astral-tl to v0.7.10 (#16887)" to narrow down a regression causing hangs in metadata retrieval (#16938)

Documentation

• Link to the uv version in crates.io member READMEs (#16939)

Install uv 0.9.15

Install prebuilt binaries via shell script

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

Download uv 0.9.15

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2025-12-01.

Performance

• Bump astral-tl to v0.7.10 to enable SIMD for HTML parsing (#16887)

Bug fixes

• Allow earlier post releases with exclusive ordering (#16881)
• Prefer updating existing .zshenv over creating a new one in tool update-shell (#16866)
• Respect -e flags in uv add (#16882)

Enhancements

• Attach subcommand to User-Agent string (#16837)
• Prefer UV_WORKING_DIR over UV_WORKING_DIRECTORY for consistency (#16884)

Install uv 0.9.14

Install prebuilt binaries via shell script

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

Download uv 0.9.14

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>