astral-sh-uv/CHANGELOG.md

Changelog

0.11.23

Released on 2026-06-19.

Bug fixes

• Revert "Fix transparent Python upgrades in project environments" to mitigate unintended breakage in pre-commit-uv (#19925)
• Restore old behavior where workspace members "hidden" by an intermediate pyproject.toml would be treated as standalone projects (#19926)

0.11.22

Released on 2026-06-18.

Enhancements

• Publish wheels before sdists in uv publish (#19831)
• Add TY and RUFF env vars for providing paths for binaries used by uv format and uv check (#19821)

Preview features

• Allow configuring preview features in uv.toml and pyproject.toml (#18437)
• Update the lockfile during uv check --no-sync (#19909)
• Add --script to uv check and uv metadata (#19860)
• Report workspace-exclusive dependency groups in workspace metadata (#19862)
• Support SARIF as a uv audit output (#19872)

Performance

• Use a more deadlock-resistant concurrent hashmap in the resolver (#19532)

Bug fixes

• Update string marker ordering semantics to match upstream clarified rules (#19808)
• Reject extras that have the same normalized name (#19871)
• Reject dependency group include-group entries that have additional fields (#19866)
• Reject invalid UTF-8 URL credentials (#19814)
• Validate that PEP 517 backend-paths exist when building sdists (#19834)
• Validate that pylock.toml files do not have an unsupported a lock-version (#19869)
• Validate that the environment satisfies the packages.requires-python of a pylock.toml (#19868)
• Allow uv to be recursively invoked by PEP 517 build hooks (#19879)
• Allow empty credentials.toml files (#19815)
• Fix transparent Python upgrades in project environments (#19890)
• Handle non-file editable URLs in uv pip list (#19867)
• Fix incorrect output from uv tree --invert (#19910)
• Fix environment locking of uv venv in a project (#19837)
• Fix handling of workspace-exclusive dependency groups in uv tree (#19905)

Documentation

• Archive the 0.10.x changelog (#19813)

Other changes

• Mark more tests as requiring network for vendors that need to run tests offline (#19819)

0.11.21

Released on 2026-06-11.

Python

• Add CPython 3.13.14 and 3.14.6 (#19787)

Preview features

• Add environment.root to uv workspace metadata --sync (#19760)
• Allow uv upgrade to update a single dependency constraint (#19738)
• Compute and pass uv workspace metadata payload in ty check (#19763)
• Make packaged applications the default for uv init (#17841)

Performance

• Add parallel discovery of Python versions for uv python list (#18684)
• Avoid normalizing source distribution names twice (#19784)

Bug fixes

• Improve cache robustness and pruning behavior
  • Allow CI cache pruning without an sdist bucket (#19802)
  • Avoid overflow when reading malformed cache entries (#19799)
  • Preserve cached Python downloads during cache pruning (#19795)
  • Reject running inside the cache (#19659)
• Fix Python discovery and version request edge cases
  • Avoid panics for Unicode Python version requests (#19797)
  • Fix handling of non-critical errors in uv python list with path requests (#19774)
  • Fix stop-discovery-at regression (#19769)
• Harden parsing and validation for package metadata, requirements, markers, URLs, and conflict sets
  • Allow trailing commas in version specifiers (#19806)
  • Avoid panics for invalid UTF-8 URL credentials (#19800)
  • Avoid panics for malformed source distribution filenames (#19776)
  • Avoid panics for trailing extra separators (#19779)
  • Avoid stack overflow for recursive requirements path aliases (#19777)
  • Ignore reversed string compatible-release markers (#19782)
  • Reject duplicate entries in conflict sets (#19801)
  • Reject malformed hash options in requirements files (#19783)
  • Reject source distribution filenames without a separator (#19803)
  • Use UTF-8 lengths for requirement errors (#19781)
  • Use UTF-8 lengths for trailing marker errors (#19796)
  • Use byte offsets when peeking over requirements (#19780)
  • Validate GraalPy ABI suffixes (#19805)
• Improve wheel entry-point error handling and virtual environment activation quoting
  • Propagate errors when reading wheel entry points (#19794)
  • Quote virtual environment activation paths with shell metacharacters (#19798)

0.11.20

Released on 2026-06-10.

Enhancements

• Add --emit-index-url and --emit-find-links to uv export (#18370)
• Add --find-links support for uv pip list (#16103)
• Group executable install errors during uv python install (#19691)
• Use ICF in macOS release builds to reduce binary sizes (#19615)

Preview features

• Add initial hidden uv upgrade command (#19678)
• Reject Git revisions in uv upgrade (#19742)

Configuration

• Recognize UV_NO_INSTALL_PROJECT, UV_NO_INSTALL_WORKSPACE, UV_NO_INSTALL_LOCAL (#19323)

Performance

• Speed up discovery of large workspaces (#18311)

Bug fixes

• Allow unknown preview flags with a warning again (#19669)
• Apply dependency exclusions to direct requirements (#19699)
• Avoid following external symlinks during cache clean (#19682)
• Avoid following symlinks during cache prune (#19543)
• Fix Git cache keys for worktrees and packed refs (#19706)
• Make resolver error handling iterative to avoid stack overflows (#19695)
• Pass VIRTUAL_ENV through cygpath inside fish on Windows (#19703)
• Rebuild explicit local directory tool installs (#19591)
• Validate egg top-level entries as identifiers (#19679)

Documentation

• Document --find-links caching behavior (#19585)
• Add a small section for malware checks (#19680)

0.11.19

Released on 2026-06-03.

Python

• Add CPython 3.15.0b2 (#19531)

Enhancements

• Always compute SHA256 for remote distributions (#19662)
• Add PyEmscripten platform (PEP 783) (#19629)
• Add Pyodide 2025 target triple (#19653)

Preview features

• Make preview features for commands have names that aren't ambiguous with the command (#19645)
• Respect --isolated in uv check (#19666)

Bug fixes

• Continue tool uninstall after dangling receipts (#19623)
• Skip Unix-specific installation steps when cross-installing Windows Python distributions (#19424)

0.11.18

Released on 2026-06-01.

Performance

• Fix performance regression in unzip of local wheels (#19637)

Preview

• Add uv check to run ty from uv (#19605)

Bug fixes

• Update activation scripts with upstream fixes (#19628)

Other changes

• Bump MSRV to 1.94 (#19600)

0.11.17

Released on 2026-05-28.

Enhancements

• Add a diagnostic for uv add with standard library modules (#19572)
• Expose uv workspace and its list subcommand in help output (#19533)
• Improve the "403 forbidden" hint to suggest ignore-error-codes when applicable (#19521)
• Skip direct URL lock freshness checks while offline (#19596)
• Add import-names and import-namespaces support to uv-build (PEP 794) (#19380)
• Add a --no-editable-package flag to various commands (#19584)
• Infer Python version requests from source trees in uv tool invocations (#19577)

Preview features

• Add module owners to uv workspace metadata (#19122)
• Do not allow uv venv --clear to remove non-virtual environments (#19595)

Bug fixes

• Improve the performance of large entries in tool.uv.conflicts (#19538)
• Avoid modifying the parent process' env with --env-file in uv run (#19567)
• Fix script environment creation for scripts with long filenames (#19539)
• Fix transitive Git archive dependencies in lockfiles (#19589)
• Preserve Git repository URLs in direct URL metadata (#19590)
• Support redirects in --check-url (#19594)
• Accept case-insensitive HTML tags in --find-links parsing (#19537)
• Reject duplicate script metadata blocks (#19544)
• Ban names like "python3" as script entry points (#19535, #19536)
• Validate Git LFS artifacts for Git archives (#19592)
• Use a relative path when creating symlinks in cache to improve relocatability (#19033)

Documentation

• Fix malformed positional anchors in the CLI reference (#19575)

0.11.16

Released on 2026-05-21.

Enhancements

• Add support for direct archive dependencies in Git (#10072)
• Adjust hint rendering (#18090)

Preview features

• uv audit: specialize malformed OSV error (#19515)
• Reject locked malware installations (#18936)

Configuration

• Allow disabling reading the system config with UV_NO_SYSTEM_CONFIG (#19476)

Bug fixes

• Allow environment variables that take a list to be empty (#19503)
• Ensure that incompatible wheel hints do not leak secrets (#19504)
• Reject unsafe entry points in uv-build (#19495)
• Restrict delimiters in entry point parsing (#19471)
• uv-netrc: fix multi-word no-space comment lines causing parse errors (#19494)

Documentation

• Document and test relative exclude-newer support for uv pip (#19475)

0.11.15

Released on 2026-05-18.

Security

• Fix a TAR parser differential, see GHSA-3cv2-h65g-fgmm (#19463)
• Enforce that entry points cannot escape in the scripts directory, see GHSA-4gg8-gxpx-9rph (#19464)

Enhancements

• Add TOML v1.1 -> v1.0 backwards compatibility for source distributions (#18741)
• Add support for Azure request signing (#19421)
• Apply stricter validation to all wheel filename segments (#19364)
• Reject empty strings as an invalid package name (#19435)
• Use structured errors for signing authentication failures (#19422)

Preview

• uv audit: Add JSON output (#19305)

Configuration

• Respect required-environments in uv pip compile (#19378)

Performance

• Avoid parsing JSON manifest when local Python is available (#19398)
• Avoid walking nested directories in linker conflict registration (#19382)
• Optimize async wheel ZIP writing (#19383)
• Fix dead "already trimmed" fast-path in Version::only_release_trimmed (#19425)

Bug fixes

• Apply workspace-member [tool.uv.sources] credentials under uv sync --frozen (#19423)
• Skip empty directories in uv build outputs (#19437)
• Fix Git submodule handling when using relative paths (#12156)
• Fix line number reporting in netrc parsing (#19452)

Documentation

• Move Bazel auth helper setup into integration guide (#19392)

0.11.14

Released on 2026-05-12.

Enhancements

• Add Astral mirror URL override (#19206)
• Ignore top_level.txt entries in uninstall that are not valid Python identifiers (#19340)

Bug fixes

• Avoid applying .env files in parent process (#19343)
• Filter ANSI codes in logging output (#19311)
• Fix uv tree showing extra-conditional deps for packages required without extras (#19332)
• Respect build options (e.g., --no-build) during lock validation (#19366)

0.11.13

Released on 2026-05-10.

Bug fixes

• Include data files in editable builds (#19312)
• Respect --require-hashes when installing from pylock.toml files (#19334)

Python

Python

• Add CPython 3.14.5

0.11.12

Released on 2026-05-08.

Python

• Add CPython 3.15.0b1

Enhancements

• Add --no-editable support to uv pip install (#19306)
• Require git refs in URLs to be percent-encoded (#19320)

Bug fixes

• Respect --no-dev over UV_DEV=1 (#19313)
• Don't suggest non-existent --no-frozen flag (#19290) (#19294)

Documentation

• Fix bug from inconsistent workflow name in GHA-PyPI guide example (#19309)

0.11.11

Released on 2026-05-06.

Bug fixes

• Accept legacy ID format from pre-0.11.9 cache entries (#19301)

0.11.10

Released on 2026-05-05.

Bug fixes

• Allow pre-release Python requests with non-zero patch versions (#19286)

0.11.9

Released on 2026-05-04.

This release includes a special release candidate for the next Python 3.14 patch release. Python 3.14 included a new garbage collection implementation, which reduced pause times but caused significant unexpected memory pressure in production environments. In 3.14.5 and 3.15, the previous garbage collection implementation will be restored.

We would greatly appreciate if you tested the 3.14.5rc1 version included in this release. The stable version is expected to be released soon and any feedback on potential issues would be helpful to the Python development team.

For more context, see the announcement, issue, and pull request.

Issues with the new release can be reported in the uv or CPython issue trackers.

Python

• Upgrade PyPy to v7.3.22
• Add CPython 3.14.5rc1
• On macOS, CPython statically links libpython to match Linux

Enhancements

• Omit compatible release desugaring for pre-release hints (#19267)
• Fix file locks on Android (#18323)

Preview

• uv audit add reporting for adverse project statuses (#19128)

Bug fixes

• Discover versioned Python executables when requires-python pins a version (#18700)
• Fix URL prefix matching to require path boundaries (#19154)
• Fix transitive Git path dependencies in lockfiles (#19269)
• Handle incorrect unlock error in LockedFile::drop on Wine (#19229)
• Prevent uninstalling site-packages for empty top_level.txt in .egg-info (#19114)
• Use symlinks instead of junctions on Wine (#19213)
• Fix floating-point environment handling on ARMv7 (#19157)
• Redact credentials from remote requirements URL in offline errors (#19216)
• Windows tramplolines no longer set PYTHONHOME and only set __PYVENV_LAUNCHER__ for virtual environments (#19199)

Documentation

• Mark --native-tls and UV_NATIVE_TLS as deprecated (#18705)
• Re-add pytorch-triton-rocm to PyTorch ROCm docs (#19241)
• Tweak changelog entries for 0.11.8 (#19188)
• Add 'Exporting lockfiles' to the Concepts->Projects index (#19209)
• Clarify that uv init creates git files / folders in the projects guide (#19183)

0.11.8

Released on 2026-04-27.

Enhancements

• Add --python-downloads-json-url to python pin (#19092)
• Fetch uv from Astral mirror during self-update (#18682)
• Support pip uninstall -y (#19082)
• Allow exclude-newer to be missing from the lockfile when exclude-newer-span is present (#19024)
• Only show the version number in uv self version --short (#19019)
• Silence warnings on empty SSL_CERT_DIR directory (#19018)
• Use a sentinel timestamp for relative exclude-newer and exclude-newer-package values in lockfiles (#19022, #19101)

Configuration

• Add UV_PYTHON_NO_REGISTRY (#19035)
• Add an environment variable for UV_NO_PROJECT (#19052)
• Expose UV_PYTHON_SEARCH_PATH for Python discovery PATH overrides (#19034)

Bug fixes

• Add rust-toolchain.toml to uv-build sdist (#19131)
• Ensure uv invocations of git do not inherit repository location environment variables (#19088)
• Redact pre-signed upload URLs in verbose output (#19146)
• Handle transitive URL dependencies in PEP 517 build requirements (#19076, #19086)
• Support uv lock on a pyproject.toml that only contains dependency-groups (#19087)
• Disable transparent Python upgrades in projects when a patch version is requested via .python-version (#19102)
• Fix Python variant tagging in the Windows registry (#19012)
• Ban external symlinks in .tar.zst wheels (#19144)

Distributions

• Remove deprecated license classifiers from uv-build and add Python 3.14 classifier (#19130)

Documentation

• Bump astral-sh/setup-uv version in docs (#19030)
• Update PyTorch documentation for PyTorch 2.11 (#19095)

0.11.7

Released on 2026-04-15.

Python

• Upgrade CPython build to 20260414 including an OpenSSL security upgrade (#19004)

Enhancements

• Elevate configuration errors to required-version mismatches (#18977)
• Further improve TLS certificate validation messages (#18933)
• Improve --exclude-newer hints (#18952)

Preview features

• Fix --script handling in uv audit (#18970)
• Fix traversal of extras in uv audit (#18970)

Bug fixes

• De-quote workspace metadata in linehaul data (#18966)
• Avoid installing tool workspace member dependencies as editable (#18891)
• Emit JSON report for uv sync --check failures (#18976)
• Filter and warn on invalid TLS certificates (#18951)
• Fix equality comparisons for version specifiers with ~= operators (#18960)
• Fix stale Python upgrade preview feature check in project environment construction (#18961)
• Improve Windows path normalization (#18945)

0.11.6

Released on 2026-04-09.

This release resolves a low severity security advisory in which wheels with malformed RECORD entries could delete arbitrary files on uninstall. See GHSA-pjjw-68hj-v9mw for details.

Bug fixes

• Do not remove files outside the venv on uninstall (#18942)
• Validate and heal wheel RECORD during installation (#18943)
• Avoid uv cache clean errors due to Win32 path normalization (#18856)

0.11.5

Released on 2026-04-08.

Python

• Add CPython 3.13.13, 3.14.4, and 3.15.0a8 (#18908)

Enhancements

• Fix build_system.requires error message (#18911)
• Remove trailing path separators in path normalization (#18915)
• Improve error messages for unsupported or invalid TLS certificates (#18924)

Preview features

• Add exclude-newer to [[tool.uv.index]] (#18839)
• uv audit: add context/warnings for ignored vulnerabilities (#18905)

Bug fixes

• Normalize persisted fork markers before lock equality checks (#18612)
• Clear junction properly when uninstalling Python versions on Windows (#18815)
• Report error cleanly instead of panicking on TLS certificate error (#18904)

Documentation

• Remove the legacy PIP_COMPATIBILITY.md redirect file (#18928)
• Fix uv init example-bare --bare examples (#18822, #18925)

0.11.4

Released on 2026-04-07.

Enhancements

• Add support for --upgrade-group (#18266)
• Merge repeated archive URL hashes by version ID (#18841)
• Require all direct URL hash algorithms to match (#18842)

Bug fixes

• Avoid panics in environment finding via cycle detection (#18828)
• Enforce direct URL hashes for pyproject.toml dependencies (#18786)
• Error on --locked and --frozen when script lockfile is missing (#18832)
• Fix uv export extra resolution for workspace member and conflicting extras (#18888)
• Include conflicts defined in virtual workspace root (#18886)
• Recompute relative exclude-newer values during uv tree --outdated (#18899)
• Respect --exclude-newer in uv tool list --outdated (#18861)
• Sort by comparator to break specifier ties (#18850)
• Store relative timestamps in tool receipts (#18901)
• Track newly-activated extras when determining conflicts (#18852)
• Patch Cargo.lock in uv-build source distributions (#18831)

Documentation

• Clarify that --exclude-newer compares artifact upload times (#18830)

0.11.3

Released on 2026-04-01.

Enhancements

• Add progress bar for hashing phase in uv publish (#18752)
• Add support for ROCm 7.2 (#18730)
• Emit abi3t tags for every abi3 version (#18777)
• Expand uv workspace metadata with dependency information from the lock (#18356)
• Implement support for PEP 803 (#18767)
• Pretty-print platform in built wheel errors (#18738)
• Publish installers to /installers/uv/latest on the mirror (#18725)
• Show free-threaded Python in built-wheel errors (#18740)

Preview features

• Add --ignore and --ignore-until-fixed to uv audit (#18737)

Bug fixes

• Bump simple API cache (#18797)
• Don't drop blake2b hashes (#18794)
• Handle broken range request implementations (#18780)
• Remove powerpc64-unknown-linux-gnu from release build targets (#18800)
• Respect dependency metadata overrides in uv pip check (#18742)
• Support debug CPython ABI tags in environment compatibility (#18739)

Documentation

• Document false opt-out for exclude-newer-package (#18768, #18803)

0.11.2

Released on 2026-03-26.

Enhancements

• Add a dedicated Windows PE editing error (#18710)
• Make uv self update fetch the manifest from the mirror first (#18679)
• Use uv reqwest client for self update (#17982)
• Show uv self update success and failure messages with --quiet (#18645)

Preview features

• Evaluate extras and groups when determining auditable packages (#18511)

Bug fixes

• Skip redundant project configuration parsing for uv run (#17890)

0.11.1

Released on 2026-03-24.

Bug fixes

• Add missing hash verification for riscv64gc-unknown-linux-musl (#18686)
• Fallback to direct download when direct URL streaming is unsupported (#18688)
• Revert treating 'Dynamic' values as case-insensitive (#18692)
• Remove torchdata from list of packages to source from the PyTorch index (#18703)
• Special-case == Python version request ranges (#9697)

Documentation

• Cover --python <dir> in "Using arbitrary Python environments" (#6457)
• Fix version annotations for PS_MODULE_PATH and UV_WORKING_DIR (#18691)

0.11.0

Released on 2026-03-23.

Breaking changes

This release includes changes to the networking stack used by uv. While we think that breakage will be rare, it is possible that these changes will result in the rejection of certificates previously trusted by uv so we have marked the change as breaking out of an abundance of caution.

The changes are largely driven by the upgrade of reqwest, which powers uv's HTTP clients, to v0.13 which included some breaking changes to TLS certificate verification.

The following changes are included:

• rustls-platform-verifier is used instead of rustls-native-certs and webpki for certificate verification

  This change should have no effect unless you are using the native-tls option to enable reading system certificates.

  rustls-platform-verifier delegates to the system for certificate validation (e.g., Security.framework on macOS) instead of eagerly loading certificates from the system and verifying them via webpki. The effects of this change will vary based on the operating system. In general, uv's certificate validation should now be more consistent with browsers and other native applications. However, this is the most likely cause of breaking changes in this release. Some previously failing certificate chains may succeed, and some previously accepted certificate chains may fail. In either case, we expect the validation to be more correct and welcome reports of regressions.

  In particular, because more responsibility for validating the certificate is transferred to your system's security library, some features like CA constraints or revocation of certificates via OCSP and CRLs may now be used.

  This change should improve performance when using system certificate on macOS, as uv no longer needs to load all certificates from the keychain at startup.

• aws-lc is used instead of ring for a cryptography backend

  There should not be breaking changes from this change. We expect this to expand support for certificate signature algorithms.

• --native-tls is deprecated in favor of a new --system-certs flag

  The --native-tls flag is still usable and has identical behavior to --system-certs.

  This change was made to reduce confusion about the TLS implementation uv uses. uv always uses rustls not native-tls.

• Building uv on x86-64 and i686 Windows requires NASM

  NASM is required by aws-lc. If not found on the system, a prebuilt blob provided by aws-lc-sys will be used.

  If you are not building uv from source, this change has no effect.

  See the CONTRIBUTING guide for details.

• Empty SSL_CERT_FILE values are ignored (for consistency with SSL_CERT_DIR)

See #18550 for details.

Python

• Enable frame pointers for improved profiling on Linux x86-64 and aarch64

See the python-build-standalone release notes for details.

Enhancements

• Treat 'Dynamic' values as case-insensitive (#18669)
• Use a dedicated error for invalid cache control headers (#18657)
• Enable checksum verification in the generated installer script (#18625)

Preview features

• Add --service-format and --service-url to uv audit (#18571)

Performance

• Avoid holding flat index lock across indexes (#18659)

Bug fixes

• Find the dynamic linker on the file system when sniffing binaries fails (#18457)
• Fix export of conflicting workspace members with dependencies (#18666)
• Respect installed settings in uv tool list --outdated (#18586)
• Treat paths originating as PEP 508 URLs which contain expanded variables as relative (#18680)
• Fix uv export for workspace member packages with conflicts (#18635)
• Continue to alternative authentication providers when the pyx store has no token (#18425)
• Use redacted URLs for log messages in cached client (#18599)

Documentation

• Add details on Linux versions to the platform policy (#18574)
• Clarify FLASH_ATTENTION_SKIP_CUDA_BUILD guidance for flash-attn installs (#18473)
• Split the dependency bots page into two separate pages (#18597)
• Split the alternative indexes page into separate pages (#18607)

0.10.x

See changelogs/0.10.x

0.9.x

See changelogs/0.9.x

0.8.x

See changelogs/0.8.x

0.7.x

See changelogs/0.7.x

0.6.x

See changelogs/0.6.x

0.5.x

See changelogs/0.5.x

0.4.x

See changelogs/0.4.x

0.3.x

See changelogs/0.3.x

0.2.x

See changelogs/0.2.x

0.1.x

See changelogs/0.1.x