Releases: astral-sh/uv
0.10.6
Release Notes
Released on 2026-02-24.
Bug fixes
- Apply lockfile marker normalization for fork markers (#18116)
- Fix Python version selection for scripts with a
requires-pythonconflicting with.python-version(#18097) - Preserve file permissions when using reflinks on Linux (#18187)
Documentation
- Remove verbose documentation from optional dependencies help text (#18180)
Install uv 0.10.6
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.10.6/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.10.6/uv-installer.ps1 | iex"Download uv 0.10.6
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.10.5
Release Notes
Released on 2026-02-23.
Enhancements
- Add hint when named index is found in a parent config file (#18087)
- Add warning for
uv lock --frozen(#17859) - Attempt to use reflinks by default on Linux (#18117)
- Fallback to hardlinks after reflink failure before copying (#18104)
- Filter
pylock.tomlwheels by tags andrequires-python(#18081) - Validate wheel filenames are normalized during
uv publish(#17783) - Fix message when
exclude-newerinvalidates the lock file (#18100) - Change the missing files log level to debug (#18075)
Performance
- Improve performance of repeated conflicts with an extra (#18094)
Bug fixes
- Fix
--no-emit-workspacewith--all-packageson single-member workspaces (#18098) - Fix
UV_NO_DEFAULT_GROUPSrejecting truthy values like1(#18057) - Fix iOS detection (#17973)
- Propagate project-level conflicts to package extras (#18096)
- Use a global build concurrency semaphore (#18054)
Documentation
- Update documentation heading for environment variable files (#18122)
- Fix comment about
uv exportformats (#17900) - Make it clear that Windows is supported in user- and system- level configuration docs (#18106)
Install uv 0.10.5
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.10.5/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.10.5/uv-installer.ps1 | iex"Download uv 0.10.5
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.10.4
Release Notes
Released on 2026-02-17.
Enhancements
- Remove duplicate references to the affected paths when showing
uv pythonerrors (#18008) - Skip discovery of workspace members that contain only git-ignored files, including in sub-directories (#18051)
Bug fixes
- Don't panic when initialising a package at the filesystem root (e.g.
uv init / --name foo) (#17983) - Fix permissions on
wheelandsdistfiles produced by theuv_buildbuild backend (#18020) - Revert locked file change to fix locked files on NFS mounts (#18071)
Install uv 0.10.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.10.4/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.10.4/uv-installer.ps1 | iex"Download uv 0.10.4
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.10.3
Release Notes
Released on 2026-02-16.
Python
- Add CPython 3.15.0a6
Enhancements
- Don't open file locks for writing (#17956)
- Make Windows trampoline error messages consistent with uv proper (#17969)
- Log which preview features are enabled (#17968)
Preview features
- Add support for ruff version constraints and
exclude-newerinuv format(#17651) - Fix script path handling when
target-workspace-discoveryis enabled (#17965) - Use version constraints to select the default ruff version used by
uv format(#17977)
Bug fixes
- Avoid matching managed Python versions by prefixes, e.g. don't match CPython 3.10 when
cpython-3.1is specified (#17972) - Fix handling of
--allow-existingwith minor version links on Windows (#17978) - Fix panic when encountering unmanaged workspace members (#17974)
- Improve accuracy of request timing (#18007)
- Reject
u64::MAXin version segments to prevent overflow (#17985)
Documentation
- Reference Debian Trixie instead of Bookworm (#17991)
Install uv 0.10.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.10.3/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.10.3/uv-installer.ps1 | iex"Download uv 0.10.3
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.10.2
Release Notes
Released on 2026-02-10.
Enhancements
- Deprecate unexpected ZIP compression methods (#17946)
Bug fixes
- Fix
cargo-installfailing due to missinguv-testdependency (#17954)
Install uv 0.10.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.10.2/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.10.2/uv-installer.ps1 | iex"Download uv 0.10.2
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.10.1
Release Notes
Released on 2026-02-10.
Enhancements
- Don't panic on metadata read errors (#17904)
- Skip empty workspace members instead of failing (#17901)
- Don't fail creating a read-only
sdist-vX/.gitif it already exists (#17825)
Documentation
- Suggest
uv python update-shelloveruv tool update-shellin Python docs (#17941)
Install uv 0.10.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.10.1/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.10.1/uv-installer.ps1 | iex"Download uv 0.10.1
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.10.0
Release Notes
Since we released uv 0.9.0 in October of 2025, 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.
This release also includes the stabilization of preview features. Python upgrades are now stable, including the uv python upgrade command, uv python install --upgrade, and automatically upgrading Python patch versions in virtual environments when a new version is installed. The add-bounds and extra-build-dependencies settings are now stable. Finally, the uv workspace dir and uv workspace list utilities for writing scripts against workspace members are now stable.
Breaking changes
-
Require
--clearto remove existing virtual environments inuv venv(#17757)Previously,
uv venvwould prompt for confirmation before removing an existing virtual environment in interactive contexts, and remove it without confirmation in non-interactive contexts. Now,uv venvrequires the--clearflag to remove an existing virtual environment. A warning for this change was added in uv 0.8.You can opt out of this behavior by passing the
--clearflag or settingUV_VENV_CLEAR=1. -
Error if multiple indexes include
default = true(#17011)Previously, uv would silently accept multiple indexes with
default = trueand use the first one. Now, uv will error if multiple indexes are marked as the default.You cannot opt out of this behavior. Remove
default = truefrom all but one index. -
Error when an
explicitindex is unnamed (#17777)Explicit indexes can only be used via the
[tool.uv.sources]table, which requires referencing the index by name. Previously, uv would silently accept unnamed explicit indexes, which could never be referenced. Now, uv will error if an explicit index does not have a name.You cannot opt out of this behavior. Add a
nameto the explicit index or remove the entry. -
Install alternative Python executables using their implementation name (#17756, #17760)
Previously,
uv python installwould install PyPy, GraalPy, and Pyodide executables with names likepython3.10into the bin directory. Now, these executables will be named using their implementation name, e.g.,pypy3.10,graalpy3.10, andpyodide3.12, to avoid conflicting with CPython installations.You cannot opt out of this behavior.
-
Respect global Python version pins in
uv tool runanduv tool install(#14112)Previously,
uv tool runanduv tool installdid not respect the global Python version pin (set viauv python pin --global). Now, these commands will use the global Python version when no explicit version is requested.For
uv tool install, if the tool is already installed, the Python version will not change unless--reinstallor--pythonis provided. If the tool was previously installed with an explicit--pythonflag, the global pin will not override it.You can opt out of this behavior by providing an explicit
--pythonflag. -
Remove Debian Bookworm, Alpine 3.21, and Python 3.8 Docker images (#17755)
The Debian Bookworm and Alpine 3.21 images were replaced by Debian Trixie and Alpine 3.22 as defaults in uv 0.9. These older images are now removed. Python 3.8 images are also removed, as Python 3.8 is no longer supported in the Trixie or Alpine base images.
The following image tags are no longer published:
uv:bookworm,uv:bookworm-slimuv:alpine3.21uv:python3.8-*
Use
uv:debianoruv:trixieinstead ofuv:bookworm,uv:alpineoruv:alpine3.22instead ofuv:alpine3.21, and a newer Python version instead ofuv:python3.8-*. -
Drop PPC64 (big endian) builds (#17626)
uv no longer provides pre-built binaries for PPC64 (big endian). This platform appears to be largely unused and is only supported on a single manylinux version. PPC64LE (little endian) builds are unaffected.
Building uv from source is still supported for this platform.
-
Skip generating
activate.cshfor relocatable virtual environments (#17759)Previously,
uv venv --relocatablewould generate anactivate.cshscript that contained hardcoded paths, making it incompatible with relocation. Now, theactivate.cshscript is not generated for relocatable virtual environments.You cannot opt out of this behavior.
-
Require username when multiple credentials match a URL (#16983)
When using
uv auth loginto store credentials, you can register multiple username and password combinations for the same host. Previously, when uv needed to authenticate and multiple credentials matched the URL (e.g., when retrieving a token withuv auth token), uv would pick the first match. Now, uv will error instead.You cannot opt out of this behavior. Include the username in the request, e.g.,
uv auth token --username foo example.com. -
Avoid invalidating the lockfile versions after an
exclude-newerchange (#17721)Previously, changing the
exclude-newersetting would cause package versions to be upgraded, ignoring the lockfile entirely. Now, uv will only change package versions if they are no longer within theexclude-newerrange.You can restore the previous behavior by using
--upgradeor--upgrade-packageto opt-in to package version changes. -
Upgrade
uv formatto Ruff 0.15.0 (#17838)uv formatnow uses Ruff 0.15.0, which uses the 2026 style guide. See the blog post for details.The formatting of code is likely to change. You can opt out of this behavior by requesting an older Ruff version, e.g.,
uv format --version 0.14.14. -
Update uv crate test features to use
test-as a prefix (#17860)This change only affects redistributors of uv. The Cargo features used to gate test dependencies, e.g.,
pypi, have been renamed with atest-prefix for clarity, e.g.,test-pypi.
Stabilizations
-
uv python upgradeanduv python install --upgrade(#17766)When installing Python versions, an intermediary directory without the patch version attached will be created, and virtual environments will be transparently upgraded to new patch versions.
See the Python version documentation for more details.
-
uv add --boundsand theadd-boundsconfiguration option (#17660)This does not come with any behavior changes. You will no longer see an experimental warning when using
uv add --boundsoradd-boundsin configuration. -
uv workspace listanduv workspace dir(#17768)This does not come with any behavior changes. You will no longer see an experimental warning when using these commands.
-
extra-build-dependencies(#17767)This does not come with any behavior changes. You will no longer see an experimental warning when using
extra-build-dependenciesin configuration.
There are no breaking changes to uv_build. If you have an upper bound in your [build-system] table, you should update it, e.g., from <0.10.0 to <0.11.0.
Enhancements
- Improve ABI tag error message phrasing (#17878)
- Introduce a 10s connect timeout (#17733)
- Allow using
pyx.devas a target inuv authcommands despitePYX_API_URLdiffering (#17856)
Bug fixes
- Support all CPython ABI tag suffixes properly (#17817)
- Add support for detecting PowerShell on Linux and macOS (#17870)
- Retry timeout errors for streams (#17875)
Install uv 0.10.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.10.0/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.10.0/uv-installer.ps1 | iex"Download uv 0.10.0
| File | Platform | Checksum |
|---|---|---|
| uv-aarch64-apple-darwin.tar.gz | Apple Silicon macOS | [checksum](https://github.com/astral-sh/uv/releases/download/0.10.0/uv-aarch64... |
0.9.30
Release Notes
Released on 2026-02-04.
Python
- Add CPython 3.14.3 and 3.13.12 (#17849)
Enhancements
- Allow comma-separated values for
--extraoption (#17525) - Check all files during a dry-run publish instead of stopping at the first failure (#17785)
- Clarify
UV_HTTP_TIMEOUTerror message (#17493)
Preview features
- Use relocatable virtual environments by default (#17770)
Bug fixes
- Fix deadlock on token refresh in
uv publishwhen using pyx (#17832) - Ignore global Python pins when incompatible with project (#15473)
Install uv 0.9.30
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.30/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.30/uv-installer.ps1 | iex"Download uv 0.9.30
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.29
Release Notes
Released on 2026-02-03.
Python
- Update to Pyodide 0.29.3 (#17730)
Enhancements
- Add wheel-tag-style aliases for manylinux platform names (#17750)
- Hint on
uv version --bump devsimilar to pre-release bumps (#17796) - Improve display of RFC 9457 Problem Detail responses in
uv publishserver errors (#17787) - Improve the wording of publish errors during dry-run (#17782)
- Set backoff to 10 retries (#17816)
- Add properties to synthentic and project roots in Cyclone DX exports (#17820)
- Identify the invidividual clients in
uv publishtrace logs (#17784)
Preview features
- Remove special casing for
baseanddefaultconda environment names (#17758)
Bug fixes
- Fix
PYTHONHOMEinheritance when spawning different Python versions (#17821) - Fix wheel rejections on freethreading+debug builds (#17812)
- Pad with zeros during comparisons in
EqualStarandNotEqualStaroperators (#17751) - Reject unknown field names in conflict declarations (#17727)
- Fix panics in
system-configurationin sandboxes (#17829)
Documentation
- Update pip pre-release compatibility information (#17788)
Security
- Hide a subset of environment variable values in
--help(#17745)
Install uv 0.9.29
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.29/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.29/uv-installer.ps1 | iex"Download uv 0.9.29
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. 992E 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.28
Release Notes
Released on 2026-01-29.
Python
- Update CPython to use OpenSSL 3.5.5 which includes fixes for high severity CVEs (python-build-standalone#960)
Enhancements
- Add support for Pyodide interpreter on Windows (#17658)
- Warn if multiple indexes include
default = true(#17713) - Skip uploads when validation reports 'Already uploaded' (#17412)
Configuration
- Add a reflink alias for the "clone" link mode (#17724)
Bug fixes
- Ensure
uv.exeexits whenuvw.exeoruvx.exeis killed (#17500)
Install uv 0.9.28
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.9.28/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.9.28/uv-installer.ps1 | iex"Download uv 0.9.28
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>