Release Notes

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 in uv publish (#16234)
• Add uv tool list --show-python (#15814)

Documentation

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

Install uv 0.9.2

Install prebuilt binaries via shell script

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

Download uv 0.9.2

Release Notes

Released on 2025-10-09.

Enhancements

• Log Python choice in uv init (#16182)
• Fix pylock.toml config conflict error messages (#16211)

Configuration

• Add UV_UPLOAD_HTTP_TIMEOUT and respect UV_HTTP_TIMEOUT in uploads (#16040)
• Support UV_WORKING_DIRECTORY for setting --directory (#16125)

Bug fixes

• Allow missing Scripts 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 on requires-python (#15927)
• Document uv version environment variables were added in (#15196)

Install uv 0.9.1

Install prebuilt binaries via shell script

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

Download uv 0.9.1

Release Notes

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 our Python 3.14 blog post for some discussion of features we're excited about!

There are no breaking changes to uv_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, then uv 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., for uv venv or uvx 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., with 3.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 with uv python install 3.14. However, e.g., if a free-threaded interpreter comes before a GIL-enabled build on the PATH, 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, the uv:alpine Docker image was based on Alpine 3.21. Now, this image is based on Alpine 3.22. The previous image can be recovered with uv:alpine3.21 and will continue to be updated until a future release.

• Upgrade Debian Docker images to Debian 13 "Trixie"

  Previously, the uv:debian and uv: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 with uv:bookworm and uv:bookworm-slim and will continue to be updated until a future release.

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

  When using uv build in a workspace, the artifacts are intended to be written to a dist directory in the workspace root. A bug caused workspace root determination to fail when the input path included a trailing / causing the dist 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

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

Documentation

• Update uv pip compile args in layout.md (#16155)

Install uv 0.9.0

Install prebuilt binaries via shell script

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

Download uv 0.9.0

Release Notes

Released on 2025-10-06.

Enhancements

• Emit a message on cache clean and prune when lock is held (#16138)
• Add --force flag for uv 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

Release Notes

Released on 2025-10-03.

Enhancements

• Build s390x on stable Rust compiler version (#16082)
• Add UV_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 in uv 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

Release Notes

Released on 2025-09-23.

Python

• Upgrade Pyodide to 0.28.3 (#15999)

Security

• Upgrade astral-tokio-tar to 0.5.5 which hardens 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

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

Release Notes

Released on 2025-09-22.

Enhancements

• Add --force flag for uv 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

• Hide freethreaded+debug Python downloads in uv python list (#15985)
• Retain the cache lock and temporary caches during uv run and uvx (#15990)

Documentation

• Add package 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

Release Notes

Released on 2025-09-19.

Python

• Add CPython 3.14.0rc3
• Upgrade OpenSSL to 3.5.3

See the python-build-standalone release notes for more details.

Bug fixes

• Make uv cache clean parallel process safe (#15888)
• Fix implied platform_machine marker for win_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

Release Notes

Released on 2025-09-17.

Enhancements

• Add PyG packages to torch backend (#15911)
• Add handling for unnamed conda environments in base environment detection (#15681)
• Allow selection of debug build interpreters (#11520)
• Improve uv init defaults for native build backend cache keys (#15705)
• Error when pyproject.toml target does not exist for dependency groups (#15831)
• Infer check URL from publish URL when known (#15886)
• Support Gitlab CI/CD as a trusted publisher (#15583)
• Add GraalPy 25.0.0 with support for Python 3.12 (#15900)
• Add --no-clear to uv venv to disable removal prompts (#15795)
• Add conflict detection between --only-group and --extra flags (#15788)
• Allow [project] to be missing from a pyproject.toml (#14113)
• Always treat conda environments named base and root as base environments (#15682)
• Improve log message when direct build for uv_build is skipped (#15898)
• Log when the cache is disabled (#15828)
• Show pyx organization name after authenticating (#15823)
• Use _CONDA_ROOT to detect Conda base environments (#15680)
• Include blake2b hash in uv publish upload form (#15794)
• Fix misleading debug message when removing environments in uv sync (#15881)

Deprecations

• Deprecate tool.uv.dev-dependencies (#15469)
• Revert "feat(ci): build loongarch64 binaries in CI (#15387)" (#15820)

Preview features

• Propagate preview flag to client for native-auth feature (#15872)
• Store native credentials for realms with the https scheme stripped (#15879)
• Use the root index URL when retrieving credentials from the native store (#15873)

Bug fixes

• Fix uv sync --no-sources not switching from editable to registry installations (#15234)
• Avoid display of an empty string when a path is the working directory (#15897)
• Allow cached environment reuse with @latest (#15827)
• Allow escaping spaces in --env-file handling (#15815)
• Avoid ANSI codes in debug! messages (#15843)
• Improve BSD tag construction (#15829)
• Include SHA when listing lockfile changes (#15817)
• Invert the logic for determining if a path is a base conda environment (#15679)
• Load credentials for explicit members when lowering (#15844)
• Re-add triton as a torch backend package (#15910)
• Respect UV_INSECURE_NO_ZIP_VALIDATION=1 in duplicate header errors (#15912)

Documentation

• Add GitHub Actions to PyPI trusted publishing example (#15753)
• Add Coiled integration documentation (#14430)
• Add verbose output to the getting help section (#15915)
• Document NO_PROXY support (#15816)
• Document cache-keys for native build backends (#15811)
• Add documentation for dependency group requires-python (#14282)

Install uv 0.8.18

Install prebuilt binaries via shell script

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

Download uv 0.8.18