uv 0.12.1

0.12.1
Added 4
  • Add package-specific pre-release policies with --prerelease-package
  • Support local HTML files as flat indexes
  • Add Xonsh virtual environment activation scripts (activate.xsh)
  • Add automatic fixes to uv check with --fix
Changed 3
  • Preserve filesystem paths passed to uv add --index when updating pyproject.toml
  • Parse canonical uv lockfiles directly, with a fallback for other valid TOML syntax
  • Accelerate SHA-256 hashing on non-Windows ARM64 platforms
Fixed 7
  • Flush shell startup file updates before uv tool update-shell and uv python update-shell exit
  • Make workspace-root dependency groups available to commands run from workspace members
  • Resolve --find-links paths in requirements files relative to the containing file
  • Respect configured indexes in uv tool list --outdated
  • Avoid rejecting unchanged metadata-free lockfiles when workspace dependencies share direct sources
  • Honor direct URL constraints when validating metadata-free lockfiles
  • Ignore malformed PEP 723 scripts discovered during project checks
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
FilePlatformChecksum
uv-aarch64-apple-darwin.tar.gzApple Silicon macOSchecksum
uv-x86_64-apple-darwin.tar.gzIntel macOSchecksum
uv-aarch64-pc-windows-msvc.zipARM64 Windowschecksum
uv-i686-pc-windows-msvc.zipx86 Windowschecksum
uv-x86_64-pc-windows-msvc.zipx64 Windowschecksum
uv-aarch64-unknown-linux-gnu.tar.gzARM64 Linuxchecksum
uv-i686-unknown-linux-gnu.tar.gzx86 Linuxchecksum
uv-powerpc64le-unknown-linux-gnu.tar.gzPPC64LE Linuxchecksum
uv-riscv64gc-unknown-linux-gnu.tar.gzRISCV Linuxchecksum
uv-s390x-unknown-linux-gnu.tar.gzS390x Linuxchecksum
uv-x86_64-unknown-linux-gnu.tar.gzx64 Linuxchecksum
uv-armv7-unknown-linux-gnueabihf.tar.gzARMv7 Linuxchecksum
uv-aarch64-unknown-linux-musl.tar.gzARM64 MUSL Linuxchecksum
uv-i686-unknown-linux-musl.tar.gzx86 MUSL Linuxchecksum
uv-riscv64gc-unknown-linux-musl.tar.gzRISCV MUSL Linuxchecksum
uv-x86_64-unknown-linux-musl.tar.gzx64 MUSL Linuxchecksum
uv-arm-unknown-linux-musleabihf.tar.gzARMv6 MUSL Linux (Hardfloat)checksum
uv-armv7-unknown-linux-musleabihf.tar.gzARMv7 MUSL Linuxchecksum
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>
View original

Upgraded? How did it go?

Discussion