uv 0.12.2

on Python PyPI

Release Notes

Released on 2026-08-05.

Python

• Add CPython 3.15.0rc1 (#20948)
• Add CPython 3.14.7 (#20971)

Enhancements

• Ensure diagnostic hints end with a newline to prevent malformed terminal output (#20959)

Preview features

• Audit one or all installed tools with uv tool audit (#20921)
• Report physically reclaimed disk space during cache cleanup with the cache-physical-space preview feature (#20925)

Configuration

• Add UV_RUN_RLIMIT_NOFILE to set the open-file limit for commands launched by uv run (#20926)

Performance

• Speed up uv.lock parsing for wheel entries (#20881)
• Speed up uv.lock parsing for source distribution entries (#20882)
• Speed up filename extraction from distribution URLs (#20879)
• Reduce filesystem metadata lookups during bytecode compilation (#20928)
• Reuse file metadata when building source distributions (#20927)

Bug fixes

• Preserve compatibility with older uv versions when recording artifact sizes in cached wheels and source distributions (#20963)
• Avoid including workspace-root default dependency groups when syncing or exporting a selected workspace member unless explicitly requested (#20930)

Documentation

• Separate build and publish jobs in the GitHub Actions publishing guide (#20946)
• Ensure the GitHub Actions publishing example waits for the build job to finish (#20957)
• Correct typos in the Docker integration guide (#20970)

Install uv 0.12.2

Install prebuilt binaries via shell script

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

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