uv 0.12.1

on Python PyPI

Release Notes

Released on 2026-07-31.

Enhancements

• Add package-specific pre-release policies with --prerelease-package (#20837)
• Support local HTML files as flat indexes (#20802)
• Add Xonsh virtual environment activation scripts (activate.xsh) (#19740)
• Preserve filesystem paths passed to uv add --index when updating pyproject.toml (#20817)

Preview features

• Add automatic fixes to uv check with --fix (#20793)
• Avoid rejecting unchanged metadata-free lockfiles when workspace dependencies share direct sources (#20847)
• Honor direct URL constraints when validating metadata-free lockfiles (#20796)
• Ignore malformed PEP 723 scripts discovered during project checks (#20784)
• Use ty's native script exclusion in uv check (#20742)

Performance

• Parse canonical uv lockfiles directly, with a fallback for other valid TOML syntax (#20648)
• Accelerate SHA-256 hashing on non-Windows ARM64 platforms (#20805)

Bug fixes

• Flush shell startup file updates before uv tool update-shell and uv python update-shell exit (#20842)
• Make workspace-root dependency groups available to commands run from workspace members (#20840)
• Resolve --find-links paths in requirements files relative to the containing file (#20832)
• Respect configured indexes in uv tool list --outdated (#20770)

Documentation

• Document Astral GPU indexes in the PyTorch guide (#20785)
• Use consistent dependency-group argument descriptions throughout the CLI documentation (#20823)

Install uv 0.12.1

Install prebuilt binaries via shell script

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

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