astral-sh/uv 0.12.14

on GitHub

Release Notes

Released on 2026-09-15.

Package-operation errors now use uv's standard diagnostics, with consistent hints and compact, labeled cause chains. (#17110, #21599, #21603)

Package-operation exit codes now reflect the underlying cause: expected failures return 1, while recognized operational and internal failures return 2. (#17110)

Enhancements

• Resume interrupted downloads with HTTP Range requests when supported (#21570)
• Show underlying causes and hints in user warnings (#21565)
• Show resolver hints for failed uv tool upgrade operations (#21566)

Preview features

• Export multiple dependency selections from a shared lockfile in one uv export --batch invocation with the batch-export preview feature (#21618)

Performance

• Speed up dependency resolution from local wheelhouses by reading wheel metadata in a single blocking task (#21619)
• Speed up cold resolution against large package indexes by parsing Simple API responses in bounded background workers (#21593)
• Speed up warm-cache resolution by decoding fresh HTTP cache entries in the cache-read task (#21621)

Bug fixes

• Select releases that satisfy required-environments within each resolver fork instead of combining incompatible wheel coverage across forks (#21672)
• Install packages with paths longer than MAX_PATH on Windows systems without long-path support enabled (#21625)
• Prevent uv python install from overwriting valid unmanaged Python symlinks with relative targets on Unix (#21639)
• Redact credentials and signatures from missing-path-segment URL errors (#21616)
• Avoid exceeding the configured retry budget when cached HTTP responses fail revalidation (#21640)
• Prefer bin/python over bin/python3 when discovering interpreters in Unix environments (#21559)
• Suppress managed-Python fallback warnings under --quiet (#21565)
• Keep failed uv tool upgrade errors visible with -q while suppressing them with -qq (#21566)

Install uv 0.12.14

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download uv 0.12.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/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>