Release Notes

Released on 2026-01-15.

Python

• Add CPython 3.15.0a5

Enhancements

• Add a hint to update uv when a managed Python download is not found (#17461)
• Improve cache initialization failure error message (#17469)
• Improve error message for abi3 wheels on free-threaded Python (#17442)
• Add support for --no-sources-package (#14910)

Preview features

• Add METADATA.json and WHEEL.json in uv build backend (#15510)
• Add support for GCS request signing (#17474)
• Adjust the process ulimit to the maximum allowed on startup (#17464)

Bug fixes

• Lock to avoid concurrent refresh of pyx tokens (#17479)

Documentation

• Add linting and formatting instructions to the CONTRIBUTING guide (#17470)
• Avoid rendering pyproject.toml examples for more system-level settings (#17462)

Install uv 0.9.26

Install prebuilt binaries via shell script

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

Download uv 0.9.26

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

Python

• Add CPython 3.15.0a4
• Upgrade Tcl/Tk used by CPython to 9.0

Enhancements

• Add --compile-bytecode to uv python install and uv python upgrade to compile the standard library (#17088)
• Allow disabling exclude-newer per package (#16854)
• Broadcast WM_SETTINGCHANGE on uv tool update-shell (#17404)

Preview features

• Detect workspace from uv run target (#17423)

Bug fixes

• Avoid unwrapping size for file responses (#17434)
• Use keyring authentication when retrieving tool@latest version (#17448)
• Use latest Pyodide version for each python version (#17372)
• Improve trampoline file handle closing (#17374)
• Fix error message when installing musl python on armv7 (#17213)

Install uv 0.9.25

Install prebuilt binaries via shell script

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

Download uv 0.9.25

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.

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>