v0.9.7

Compare Source

Released on 2025-10-30.

Enhancements

• Add Windows x86-32 emulation support to interpreter architecture checks (#​13475)
• Improve readability of progress bars (#​16509)
• Add GitHub attestations for uv release artifacts (#​11357)

Bug fixes

• Drop terminal coloring fromuv auth token output (#​16504)
• Don't use UV_LOCKED to enable--check flag (#​16521)

v0.9.6

Compare Source

Released on 2025-10-29.

This release contains an upgrade to Astral's fork ofasync_zip, which addresses potential sources of ZIP parsing differentials between uv and other Python packaging tooling. SeeGHSA-pqhf-p39g-3x64 for additional details.

Security

• Address ZIP parsing differentials (GHSA-pqhf-p39g-3x64)

Python

• Upgrade GraalPy to 25.0.1 (#​16401)

Enhancements

• Add--clear touv build to remove old build artifacts (#​16371)
• Add--no-create-gitignore touv build (#​16369)
• Do not error when a virtual environment directory cannot be removed due to a busy error (#​16394)
• Improve hint onpip install --system when externally managed (#​16392)
• Runninguv lock --check with outdated lockfile will print that--check was passed, instead of--locked (#​16322)
• Updateuv init template for Maturin (#​16449)
• Improve ordering of Python sources in logs (#​16463)
• Restore DockerHub release images and annotations (#​16441)

Bug fixes

• Check for matching Python implementation duringuv python upgrade (#​16420)
• Deterministically order--find-links distributions (#​16446)
• Don't panic inuv export --frozen when the lockfile is outdated (#​16407)
• Fix root ofuv tree when--package is used with circular dependencies (#​15908)
• Show package list withpip freeze --quiet (#​16491)
• Limituv auth login pyx.dev retries to 60s (#​16498)
• Add an empty group withuv add --group ... -r ... (#​16490)

Documentation

• Update docs for maturin build backend init template (#​16469)
• Update docs to reflect previous changes to signal forwarding semantics (#​16430)
• Add instructions for installing via MacPorts (#​16039)

v0.9.5

Compare Source

Released on 2025-10-21.

This release contains an upgrade toastral-tokio-tar, which addresses a vulnerability in tar extraction on malformed archives with mismatching size information between the ustar header and PAX extensions. While theastral-tokio-tar advisory has been graded as "high" due its potential broader impact, thespecific impact to uv islow due to a lack of novel attacker capability. Specifically, uv only processes tar archives from source distributions, which already possess the capability for full arbitrary code execution by design, meaning that an attacker gains no additional capabilities throughastral-tokio-tar.

Regardless, we take the hypothetical risk of parser differentials very seriously. Out of an abundance of caution, we have assigned this upgrade an advisory:GHSA-w476-p2h3-79g9

Security

• Upgradeastral-tokio-tar to 0.5.6 to address a parsing differential (#​16387)

Enhancements

• Add required environment marker example to hint (#​16244)
• Fix typo in MissingTopLevel warning (#​16351)
• Improve 403 Forbidden error message to indicate package may not exist (#​16353)
• Add a hint onuv pip install failure if the--system flag is used to select an externally managed interpreter (#​16318)

Bug fixes

• Fix backtick escaping for PowerShell (#​16307)

Documentation

• Document metadata consistency expectation (#​15683)
• Remove outdated aarch64 musl note (#​16385)

v0.9.4

Compare Source

Released on 2025-10-17.

Enhancements

• Add CUDA 13.0 support (#​16321)
• Add auto-detection for Intel GPU on Windows (#​16280)
• Implement display of RFC 9457 HTTP error contexts (#​16199)

Bug fixes

• Avoid obfuscating pyx tokens inuv auth token output (#​16345)

v0.9.3

Compare Source

Released on 2025-10-14.

Python

• Add CPython 3.15.0a1
• Add CPython 3.13.9

Enhancements

• Obfuscate secret token values in logs (#​16164)

Bug fixes

• Fix workspace with relative pathing (#​16296)

v0.9.2

Compare Source

Released on 2025-10-10.

Python

• Add CPython 3.9.24.
• Add CPython 3.10.19.
• Add CPython 3.11.14.
• Add CPython 3.12.12.

Enhancements

• Avoid inferring check URLs for pyx inuv publish (#​16234)
• Adduv tool list --show-python (#​15814)

Documentation

• Add missing "added in" to new environment variables in reference (#​16217)

v0.9.1

Compare Source

Released on 2025-10-09.

Enhancements

• Log Python choice inuv init (#​16182)
• Fixpylock.toml config conflict error messages (#​16211)

Configuration

• AddUV_UPLOAD_HTTP_TIMEOUT and respectUV_HTTP_TIMEOUT in uploads (#​16040)
• SupportUV_WORKING_DIRECTORY for setting--directory (#​16125)

Bug fixes

• Allow missingScripts directory (#​16206)
• Fix handling of Python requests with pre-releases in ranges (#​16208)
• Preserve comments on version bump (#​16141)
• Retry all HTTP/2 errors (#​16038)
• Treat deleted Windows registry keys as equivalent to missing ones (#​16194)
• Ignore pre-release Python versions when a patch version is requested (#​16210)

Documentation

• Document why uv discards upper bounds onrequires-python (#​15927)
• Document uv version environment variables were added in (#​15196)

v0.9.0

Compare Source

Released on 2025-10-07.

This breaking release is primarily motivated by the release of Python 3.14, which contains some breaking changes (we recommend reading the"What's new in Python 3.14" page). uv may use Python 3.14 in cases where it previously used 3.13, e.g., if you have not pinned your Python version and do not have any Python versions installed on your machine. While we think this is uncommon, we prefer to be cautious. We've included some additional small changes that could break workflows.

See ourPython 3.14 blog post for some discussion of features we're excited about!

There are no breaking changes touv_build. If you have an upper bound in your[build-system] table, you should update it.

Breaking changes

• Python 3.14 is now the default stable version

  The default Python version has changed from 3.13 to 3.14. This applies to Python version installation when no Python version is requested, e.g.,uv python install. By default, uv will use the system Python version if present, so this may not cause changes to general use of uv. For example, if Python 3.13 is installed already, thenuv venv will use that version. If no Python versions are installed on a machine and automatic downloads are enabled, uv will now use 3.14 instead of 3.13, e.g., foruv venv oruvx python. This change will not affect users who are using a.python-version file to pin to a specific Python version.

• Allow use of free-threaded variants in Python 3.14+ without explicit opt-in (#​16142)

  Previously, free-threaded variants of Python were considered experimental and required explicit opt-in (i.e., with3.14t) for usage. Now uv will allow use of free-threaded Python 3.14+ interpreters without explicit selection. The GIL-enabled build of Python will still be preferred, e.g., when performing an installation withuv python install 3.14. However, e.g., if a free-threaded interpreter comes before a GIL-enabled build on thePATH, it will be used. This change does not apply to free-threaded Python 3.13 interpreters, which will continue to require opt-in.

• Use Python 3.14 stable Docker images (#​16150)

  Previously, the Python 3.14 images had an-rc suffix, e.g.,python:3.14-rc-alpine or
  python:3.14-rc-trixie. Now, the-rc suffix has been removed to match the stable
  upstream images. The-rc images tags will no longer be
  updated. This change should not break existing workflows.

• Upgrade Alpine Docker image to Alpine 3.22

  Previously, theuv:alpine Docker image was based on Alpine 3.21. Now, this image is based on Alpine 3.22. The previous image can be recovered withuv:alpine3.21 and will continue to be updated until a future release.

• Upgrade Debian Docker images to Debian 13 "Trixie"

  Previously, theuv:debian anduv:debian-slim Docker images were based on Debian 12 "Bookworm". Now, these images are based on Debian 13 "Trixie". The previous images can be recovered withuv:bookworm anduv:bookworm-slim and will continue to be updated until a future release.

• Fix incorrect output path when a trailing/ is used inuv build (#​15133)

  When usinguv build in a workspace, the artifacts are intended to be written to adist directory in the workspace root. A bug caused workspace root determination to fail when the input path included a trailing/ causing thedist directory to be placed in the child directory. This bug has been fixed in this release. For example,uv build child/ is used, the output path will now be in<workspace root>/dist/ rather than<workspace root>/child/dist/.

Python

• Add CPython 3.14.0
• Add CPython 3.13.8

Enhancements

• Don't warn when a dependency is constrained by another dependency (#​16149)

Bug fixes

• Fixuv python upgrade / install output when there is a no-op for one request (#​16158)
• Surface pinned-version hint whenuv tool upgrade can’t move the tool (#​16081)
• Ban pre-release versions inuv python upgrade requests (#​16160)
• Fixuv python upgrade replacement of installed binaries on pre-release to stable (#​16159)

Documentation

• Updateuv pip compile args inlayout.md (#​16155)

v0.8.24

Compare Source

Release Notes

Released on 2025-10-06.

Enhancements

• Emit a message oncache clean andprune when lock is held (#​16138)
• Add--force flag foruv cache prune (#​16137)

Documentation

• Fix example of bumping beta version without patch bump (#​16132)

Install uv 0.8.24

Install prebuilt binaries via shell script

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

Download uv 0.8.24

v0.8.23

Compare Source

Release Notes

Released on 2025-10-03.

Enhancements

• Builds390x on stable Rust compiler version (#​16082)
• AddUV_SKIP_WHEEL_FILENAME_CHECK to allow installing invalid wheels (#​16046)

Bug fixes

• Avoid rejecting already-installed URL distributions with--no-sources (#​16094)
• Confirm that the directory name is a valid Python install key during managed check (#​16080)
• Ignore origin when comparing installed tools (#​16055)
• Make cache control lookups robust to username (#​16088)
• Re-order lock validation checks by severity (#​16045)
• Remove tracking of inferred dependency conflicts (#​15909)
• Respect--no-color on the CLI (#​16044)
• Deduplicate marker-specific dependencies inuv pip tree output (#​16078)

Documentation

• Document transparent x86_64 emulation on aarch64 (#​16041)
• Document why we ban URLs from index dependencies (#​15929)
• Fix rendering of_CONDA_ROOT in reference (#​16114)
• Windows arm64 and Linux RISC-V64 are Tier 2 supported (#​16027)

Install uv 0.8.23

Install prebuilt binaries via shell script

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

Download uv 0.8.23

v0.8.22

Compare Source

Release Notes

Released on 2025-09-23.

Python

• Upgrade Pyodide to 0.28.3 (#​15999)

Security

• Upgradeastral-tokio-tar to 0.5.5 whichhardens tar archive extraction (#​16004)

Install uv 0.8.22

Install prebuilt binaries via shell script

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

Download uv 0.8.22

v0.8.21

Compare Source

Release Notes

+Released on 2025-09-23.

Enhancements

• Refresh lockfile when--refresh is provided (#​15994)

Preview features

Add support for S3 request signing (#​15925)

Install uv 0.8.21

Install prebuilt binaries via shell script

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

Download uv 0.8.21

v0.8.20

Compare Source

Release Notes

Released on 2025-09-22.

Enhancements

• Add--force flag foruv cache clean (#​15992)
• Improve resolution errors with proxied packages (#​15200)

Preview features

• Allow upgrading pre-release versions of the same minor Python version (#​15959)

Bug fixes

• Hidefreethreaded+debug Python downloads inuv python list (#​15985)
• Retain the cache lock and temporary caches duringuv run anduvx (#​15990)

Documentation

• Addpackage level conflicts to the conflicting dependencies docs (#​15963)
• Document pyodide support (#​15962)
• Document support for free-threaded and debug Python versions (#​15961)
• Expand the contribution docs on issue selection (#​15966)
• Tweak title for viewing version in project guide (#​15964)

Install uv 0.8.20

Install prebuilt binaries via shell script

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

Download uv 0.8.20

v0.8.19

Compare Source

Release Notes

Released on 2025-09-19.

Python

• Add CPython 3.14.0rc3
• Upgrade OpenSSL to 3.5.3

See thepython-build-standalone release notes for more details.

Bug fixes

• Makeuv cache clean parallel process safe (#​15888)
• Fix impliedplatform_machine marker forwin_arm64 platform tag (#​15921)

Install uv 0.8.19

Install prebuilt binaries via shell script

curl --proto'=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.19/uv-installer.sh| sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c"irm https://github.com/astral-sh/uv/releases/download/0.8.19/uv-installer.ps1 | iex"

Download uv 0.8.19