# uv 0.12.2

- Product: uv (https://whatsnew.fyi/product/uv)
- Vendor: uv
- Date: 2026-08-05
- Version: 0.12.2
- Original notes: https://github.com/astral-sh/uv/releases/tag/0.12.2
- Permalink: https://whatsnew.fyi/product/uv/releases/0.12.2

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Add CPython 3.15.0rc1
- **added** — Add CPython 3.14.7
- **added** — Audit one or all installed tools with `uv tool audit`
- **added** — Report physically reclaimed disk space during cache cleanup with the `cache-physical-space` preview feature
- **added** — Add `UV_RUN_RLIMIT_NOFILE` to set the open-file limit for commands launched by `uv run`
- **changed** — Ensure diagnostic hints end with a newline to prevent malformed terminal output
- **changed** — Speed up `uv.lock` parsing for wheel entries
- **changed** — Speed up `uv.lock` parsing for source distribution entries
- **changed** — Speed up filename extraction from distribution URLs
- **changed** — Reduce filesystem metadata lookups during bytecode compilation
- **changed** — Reuse file metadata when building source distributions
- **fixed** — Preserve compatibility with older uv versions when recording artifact sizes in cached wheels and source distributions
- **fixed** — Avoid including workspace-root default dependency groups when syncing or exporting a selected workspace member unless explicitly requested

##### Release Notes

Released on 2026-08-05.

###### Python

- Add CPython 3.15.0rc1 ([#20948](https://github.com/astral-sh/uv/pull/20948))
- Add CPython 3.14.7 ([#20971](https://github.com/astral-sh/uv/pull/20971))

###### Enhancements

- Ensure diagnostic hints end with a newline to prevent malformed terminal output ([#20959](https://github.com/astral-sh/uv/pull/20959))

###### Preview features

- Audit one or all installed tools with `uv tool audit` ([#20921](https://github.com/astral-sh/uv/pull/20921))
- Report physically reclaimed disk space during cache cleanup with the `cache-physical-space` preview feature ([#20925](https://github.com/astral-sh/uv/pull/20925))

###### Configuration

- Add `UV_RUN_RLIMIT_NOFILE` to set the open-file limit for commands launched by `uv run` ([#20926](https://github.com/astral-sh/uv/pull/20926))

###### Performance

- Speed up `uv.lock` parsing for wheel entries ([#20881](https://github.com/astral-sh/uv/pull/20881))
- Speed up `uv.lock` parsing for source distribution entries ([#20882](https://github.com/astral-sh/uv/pull/20882))
- Speed up filename extraction from distribution URLs ([#20879](https://github.com/astral-sh/uv/pull/20879))
- Reduce filesystem metadata lookups during bytecode compilation ([#20928](https://github.com/astral-sh/uv/pull/20928))
- Reuse file metadata when building source distributions ([#20927](https://github.com/astral-sh/uv/pull/20927))

###### Bug fixes

- Preserve compatibility with older uv versions when recording artifact sizes in cached wheels and source distributions ([#20963](https://github.com/astral-sh/uv/pull/20963))
- Avoid including workspace-root default dependency groups when syncing or exporting a selected workspace member unless explicitly requested ([#20930](https://github.com/astral-sh/uv/pull/20930))

###### Documentation

- Separate build and publish jobs in the GitHub Actions publishing guide ([#20946](https://github.com/astral-sh/uv/pull/20946))
- Ensure the GitHub Actions publishing example waits for the build job to finish ([#20957](https://github.com/astral-sh/uv/pull/20957))
- Correct typos in the Docker integration guide ([#20970](https://github.com/astral-sh/uv/pull/20970))

##### Install uv 0.12.2

###### Install prebuilt binaries via shell script

```sh
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

```sh
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

|  File  | Platform | Checksum |
|--------|----------|----------|
| [uv-aarch64-apple-darwin.tar.gz](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-aarch64-apple-darwin.tar.gz) | Apple Silicon macOS | [checksum](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-aarch64-apple-darwin.tar.gz.sha256) |
| [uv-x86_64-apple-darwin.tar.gz](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-x86_64-apple-darwin.tar.gz) | Intel macOS | [checksum](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-x86_64-apple-darwin.tar.gz.sha256) |
| [uv-aarch64-pc-windows-msvc.zip](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-aarch64-pc-windows-msvc.zip) | ARM64 Windows | [checksum](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-aarch64-pc-windows-msvc.zip.sha256) |
| [uv-i686-pc-windows-msvc.zip](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-i686-pc-windows-msvc.zip) | x86 Windows | [checksum](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-i686-pc-windows-msvc.zip.sha256) |
| [uv-x86_64-pc-windows-msvc.zip](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-x86_64-pc-windows-msvc.zip) | x64 Windows | [checksum](https://releases.astral.sh/github/uv/releases/download/0.12.2/uv-x86_64-pc-windows-msvc.zip.sha256) |
| [uv-aa

_[Truncated at 4000 characters — full notes: https://github.com/astral-sh/uv/releases/tag/0.12.2]_