Releases: astral-sh/uv
0.9.16
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
debugsubcommand touv pipannouncing 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-binaryet al inuv pip compile(#16956) - Support
--targetand--prefixinuv pip list,uv pip freeze, anduv 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 bazelcommand (#16886)
Bug fixes
- Fix Pyston wheel compatibility tags (#16972)
- Allow redundant entries in
tool.uv.build-backend.module-namebut emit warnings (#16928) - Fix infinite loop in non-attribute re-treats during HTML parsing (#17010)
Documentation
- Clarify
--projectflag help text to indicate project discovery (#16965) - Regenerate the crates.io READMEs on release (#16992)
- Update Docker integration guide to prefer
COPYoverADDfor 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 | shInstall 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/uvYou 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>0.9.15
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_OUTPUTto omit build logs (#16885)
Bug fixes
- Fix
uv-trampoline-builderbuilds from crates.io by moving bundled executables (#16922) - Respect
NO_COLORand always show the command as a header when paginguv helpoutput (#16908) - Use
0o666permissions for flock files instead of0o777(#16845) - Revert "Bump
astral-tlto 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 | shInstall 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/uvYou 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>0.9.14
Release Notes
Released on 2025-12-01.
Performance
- Bump
astral-tlto v0.7.10 to enable SIMD for HTML parsing (#16887)
Bug fixes
- Allow earlier post releases with exclusive ordering (#16881)
- Prefer updating existing
.zshenvover creating a new one intool update-shell(#16866) - Respect
-eflags inuv add(#16882)
Enhancements
- Attach subcommand to User-Agent string (#16837)
- Prefer
UV_WORKING_DIRoverUV_WORKING_DIRECTORYfor 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 | shInstall 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/uvYou 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>0.9.13
Release Notes
Released on 2025-11-26.
Bug fixes
- Revert "Allow
--with-requirementsto load extensionless inline-metadata scripts" to fix reading of requirements files from streams (#16861) - Validate URL wheel tags against
Requires-Pythonand required environments (#16824)
Documentation
- Drop unpublished crates from the uv crates.io README (#16847)
- Fix the links to uv in crates.io member READMEs (#16848)
Install uv 0.9.13
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.13/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.13/uv-installer.ps1 | iex"Download uv 0.9.13
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/uvYou 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>0.9.12
Release Notes
Released on 2025-11-24.
Due to a permission error during publish to crates.io, this release was partially published and manually finished. Consequently, crates.io temporarily did not include all of the artifacts and the GitHub Release was published by a maintainer instead of GitHub Actions. The artifacts from GitHub Actions were used without alteration. The GitHub release attestations for the artifacts are not available for this release.
Enhancements
- Allow
--with-requirementsto load extensionless inline-metadata scripts (#16744) - Collect and upload PEP 740 attestations during
uv publish(#16731) - Prevent
uv exportfrom overwritingpyproject.toml(#16745)
Documentation
- Add a crates.io README for uv (#16809)
- Add documentation for intermediate Docker layers in a workspace (#16787)
- Enumerate workspace members in the uv crate README (#16811)
- Fix documentation links for crates (#16801)
- Generate a crates.io README for uv workspace members (#16812)
- Move the "Export" guide to the projects concept section (#16835)
- Update the cargo install recommendation to use crates (#16800)
- Use the word "internal" in crate descriptions (#16810)
Install uv 0.9.12
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.12/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.12/uv-installer.ps1 | iex"Download uv 0.9.12
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/uvYou 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>0.9.11
Release Notes
Released on 2025-11-20.
Due to rate limiting during publish to crates.io, this release was partially published and manually finished. Consequently, crates.io temporarily did not include all of the artifacts and the GitHub Release was published by a maintainer instead of GitHub Actions. The artifacts from GitHub Actions were used without alteration. The GitHub release attestations for the artifacts are not available for this release.
Python
- Add CPython 3.15.0a2
See the python-build-standalone release notes for details.
Enhancements
Preview features
Bug fixes
- Fix
uv initauthor serialization viatoml_editinline tables (#16778) - Fix status messages without TTY (#16785)
- Preserve end-of-line comment whitespace when editing
pyproject.toml(#16734) - Disable
always-authenticatewhen running under Dependabot (#16773)
Documentation
- Document the new behavior for free-threaded python versions (#16781)
- Improve note about build system in publish guide (#16788)
- Move do not upload publish note out of the guide into concepts (#16789)
Install uv 0.9.11
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.11/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.11/uv-installer.ps1 | iex"Download uv 0.9.11
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/uvYou 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>0.9.10
Release Notes
Released on 2025-11-17.
Enhancements
- Add support for
SSL_CERT_DIR(#16473) - Enforce UTF‑8-encoded license files during
uv build(#16699) - Error when a
project.license-filesglob matches nothing (#16697) pip install --target(andsync) install Python if necessary (#16694)- Account for
python_downloads_json_urlin pre-release Python version warnings (#16737) - Support HTTP/HTTPS URLs in
uv python --python-downloads-json-url(#16542)
Preview features
- Add support for
--upgradeinuv python install(#16676) - Fix handling of
python install --defaultfor pre-release Python versions (#16706) - Add
uv workspace listto list workspace members (#16691)
Bug fixes
- Don't check file URLs for ambiguously parsed credentials (#16759)
Documentation
- Add a "storage" reference document (#15954)
Install uv 0.9.10
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.10/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.10/uv-installer.ps1 | iex"Download uv 0.9.10
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/uvYou 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>0.9.9
Release Notes
Released on 2025-11-12.
Deprecations
- Deprecate use of
--projectinuv init(#16674)
Enhancements
- Add iOS support to Python interpreter discovery (#16686)
- Reject ambiguously parsed URLs (#16622)
- Allow explicit values in
uv version --bump(#16555) - Warn on use of managed pre-release Python versions when a stable version is available (#16619)
- Allow signing trampolines on Windows by using
.rcdatato store metadata (#15068) - Add
--only-emit-workspaceand similar variants touv export(#16681)
Preview features
Configuration
- Add
UV_NO_DEFAULT_GROUPSenvironment variable (#16645)
Bug fixes
- Remove
torch-model-archiverandtorch-tb-profilerfrom PyTorch backend (#16655) - Fix Pixi environment detection (#16585)
Documentation
- Fix
CMDpath in FastAPI Dockerfile (#16701)
Install uv 0.9.9
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.9/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.9/uv-installer.ps1 | iex"Download uv 0.9.9
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/uvYou 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>0.9.8
Release Notes
Released on 2025-11-07.
Enhancements
- Accept multiple packages in
uv export(#16603) - Accept multiple packages in
uv sync(#16543) - Add a
uv cache sizecommand (#16032) - Add prerelease guidance for build-system resolution failures (#16550)
- Allow Python requests to include
+gilto require a GIL-enabled interpreter (#16537) - Avoid pluralizing 'retry' for single value (#16535)
- Enable first-class dependency exclusions (#16528)
- Fix inclusive constraints on available package versions in resolver errors (#16629)
- Improve
uv initerror for invalid directory names (#16554) - Show help on
uv build -h(#16632) - Include the Python variant suffix in "Using Python ..." messages (#16536)
- Log most recently modified file for cache-keys (#16338)
- Update Docker builds to use nightly Rust toolchain with musl v1.2.5 (#16584)
Configuration
- Expose
UV_NO_GROUPas an environment variable (#16529) - Add
UV_NO_SOURCESas an environment variable (#15883)
Bug fixes
- Allow
--checkand--lockedto be used together inuv lock(#16538) - Allow for unnormalized names in the METADATA file (#16547) (#16548)
- Fix missing value_type for
default-groupsin schema (#16575) - Respect multi-GPU outputs in
nvidia-smi(#15460) - Fix DNS lookup errors in Docker containers (#8450)
Documentation
Other changes
- Update Rust toolchain to 1.91 and MSRV to 1.89 (#16531)
Install uv 0.9.8
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.8/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.8/uv-installer.ps1 | iex"Download uv 0.9.8
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/uvYou 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>0.9.7
Release Notes
Released on 2025-10-30.
Enhancements
- Add Windows x86-32 emulation support to interpreter architecture checks (#13475)
- Improve readability of progress bars (#16509)
Bug fixes
- Drop terminal coloring from
uv auth tokenoutput (#16504) - Don't use UV_LOCKED to enable
--checkflag (#16521)
Install uv 0.9.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.7/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.7/uv-installer.ps1 | iex"