Releases: astral-sh/uv
Releases · astral-sh/uv
0.7.19
Release Notes
The uv build backend is now stable, and considered ready for production use.
The uv build backend is a great choice for pure Python projects. It has reasonable defaults, with the goal of requiring zero configuration for most users, but provides flexible configuration to accommodate most Python project structures. It integrates tightly with uv, to improve messaging and user experience. It validates project metadata and structures, preventing common mistakes. And, finally, it's very fast — uv sync on a new project (from uv init) is 10-30x faster than with other build backends.
To use uv as a build backend in an existing project, add uv_build to the [build-system] section in your pyproject.toml:
[build-system]
requires = ["uv_build>=0.7.19,<0.8.0"]
build-backend = "uv_build"In a future release, it will replace hatchling as the default in uv init. As before, uv will remain compatible with all standards-compliant build backends.
Python
- Add PGO distributions of Python for aarch64 Linux, which are more optimized for better performance
See the python-build-standalone release for more details.
Enhancements
- Ignore Python patch version for
--universalpip compile (#14405) - Update the tilde version specifier warning to include more context (#14335)
- Clarify behavior and hint on tool install when no executables are available (#14423)
Bug fixes
- Make project and interpreter lock acquisition non-fatal (#14404)
- Includes
sys.prefixin cached environment keys to avoid--withcollisions across projects (#14403)
Documentation
- Add a migration guide from pip to uv projects (#12382)
Install uv 0.7.19
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.19/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.19/uv-installer.ps1 | iex"Download uv 0.7.19
0.7.18
Release Notes
Python
-
Added arm64 Windows Python 3.11, 3.12, 3.13, and 3.14
These are not downloaded by default, since x86-64 Python has broader ecosystem support on Windows.
However, they can be requested withcpython-<version>-windows-aarch64.
Enhancements
- Keep track of retries in
ManagedPythonDownload::fetch_with_retry(#14378) - Reuse build (virtual) environments across resolution and installation (#14338)
- Improve trace message for cached Python interpreter query (#14328)
- Use parsed URLs for conflicting URL error message (#14380)
Preview features
- Ignore invalid build backend settings when not building (#14372)
Bug fixes
- Fix equals-star and tilde-equals with
python_versionandpython_full_version(#14271) - Include the canonical path in the interpreter query cache key (#14331)
- Only drop build directories on program exit (#14304)
- Error instead of panic on conflict between global and subcommand flags (#14368)
- Consistently normalize trailing slashes on URLs with no path segments (#14349)
Documentation
- Add instructions for publishing to JFrog's Artifactory (#14253)
- Edits to the build backend documentation (#14376)
Install uv 0.7.18
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.18/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.18/uv-installer.ps1 | iex"Download uv 0.7.18
0.7.17
Release Notes
Bug fixes
- Apply build constraints when resolving
--withdependencies (#14340) - Drop trailing slashes when converting index URL from URL (#14346)
- Ignore
UV_PYTHON_CACHE_DIRwhen empty (#14336) - Fix error message ordering for
pyvenv.cfgversion conflict (#14329)
Install uv 0.7.17
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.17/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.17/uv-installer.ps1 | iex"Download uv 0.7.17
0.7.16
Release Notes
Python
- Add Python 3.14.0b3
See the python-build-standalone release notes for more details.
Enhancements
- Include path or URL when failing to convert in lockfile (#14292)
- Warn when
~=is used as a Python version specifier without a patch version (#14008)
Preview features
- Ensure preview default Python installs are upgradeable (#14261)
Performance
- Share workspace cache between lock and sync operations (#14321)
Bug fixes
- Allow local indexes to reference remote files (#14294)
- Avoid rendering desugared prefix matches in error messages (#14195)
- Avoid using path URL for workspace Git dependencies in
requirements.txt(#14288) - Normalize index URLs to remove trailing slash (#14245)
- Respect URL-encoded credentials in redirect location (#14315)
- Lock the source tree when running setuptools, to protect concurrent builds (#14174)
Documentation
- Note that GCP Artifact Registry download URLs must have
/simplecomponent (#14251)
Install uv 0.7.16
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.16/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.16/uv-installer.ps1 | iex"Download uv 0.7.16
0.7.15
Release Notes
Enhancements
- Consistently use
Ordering::Relaxedfor standalone atomic use cases (#14190) - Warn on ambiguous relative paths for
--index(#14152) - Skip GitHub fast path when rate-limited (#13033)
- Preserve newlines in
schema.jsondescriptions (#13693)
Bug fixes
- Add check for using minor version link when creating a venv on Windows (#14252)
- Strip query parameters when parsing source URL (#14224)
Documentation
- Add a link to PyPI FAQ to clarify what per-project token is (#14242)
Preview features
- Allow symlinks in the build backend (#14212)
Install uv 0.7.15
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.15/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.15/uv-installer.ps1 | iex"Download uv 0.7.15
0.7.14
Release Notes
Enhancements
- Add XPU to
--torch-backend(#14172) - Add ROCm backends to
--torch-backend(#14120) - Remove preview label from
--torch-backend(#14119) - Add
[tool.uv.dependency-groups].mygroup.requires-python(#13735) - Add auto-detection for AMD GPUs (#14176)
- Show retries for HTTP status code errors (#13897)
- Support transparent Python patch version upgrades (#13954)
- Warn on empty index directory (#13940)
- Publish to DockerHub (#14088)
Performance
- Make cold resolves about 10% faster (#14035)
Bug fixes
- Don't use walrus operator in interpreter query script (#14108)
- Fix handling of changes to
requires-python(#14076) - Fix implied
platform_machinemarker forwin_amd64platform tag (#14041) - Only update existing symlink directories on preview uninstall (#14179)
- Serialize Python requests for tools as canonicalized strings (#14109)
- Support netrc and same-origin credential propagation on index redirects (#14126)
- Support reading
dependency-groupsfrom pyproject.tomls with no[project](#13742) - Handle an existing shebang in
uv init --script(#14141) - Prevent concurrent updates of the environment in
uv run(#14153) - Filter managed Python distributions by platform before querying when included in request (#13936)
Documentation
- Replace cuda124 with cuda128 (#14168)
- Document the way member sources shadow workspace sources (#14136)
- Sync documented PyTorch integration index for CUDA and ROCm versions from PyTorch website (#14100)
Install uv 0.7.14
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.14/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.14/uv-installer.ps1 | iex"Download uv 0.7.14
0.7.13
Release Notes
Python
- Add Python 3.14.0b2
- Add Python 3.13.5
- Fix stability of
uuid.getnodeon 3.13
See the python-build-standalone release notes for more details.
Enhancements
- Download versions in
uv python pinif not found (#13946) - Use TTY detection to determine if SIGINT forwarding is enabled (#13925)
- Avoid fetching an exact, cached Git commit, even if it isn't locked (#13748)
- Add
zstdanddeflatetoAccept-Encoding(#13982) - Build binaries for riscv64 (#12688)
Bug fixes
- Check if relative URL is valid directory before treating as index (#13917)
- Ignore Python discovery errors during
uv python pin(#13944) - Do not allow
uv add --group ... --script(#13997)
Preview changes
- Build backend: Support namespace packages (#13833)
Documentation
- Add 3.14 to the supported platform reference (#13990)
- Add an
llms.txtto uv (#13929) - Add supported macOS version to the platform reference (#13993)
- Update platform support reference to include Python implementation list (#13991)
- Update pytorch.md (#13899)
- Update the CLI help and reference to include references to the Python bin directory (#13978)
Install uv 0.7.13
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.13/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.13/uv-installer.ps1 | iex"Download uv 0.7.13
0.7.12
Release Notes
Enhancements
- Add
uv python pin --rmto remove.python-versionpins (#13860) - Don't hint at versions removed by
excluded-newer(#13884) - Add hint to use
tool.uv.environmentson resolution error (#13455) - Add hint to use
tool.uv.required-environmentson resolution error (#13575) - Improve
python pinerror messages (#13862)
Bug fixes
- Lock environments during
uv sync,uv addanduv removeto prevent race conditions (#13869) - Add
--no-editabletouv exportforpylock.toml(#13852)
Documentation
- List
.gitignorein project init files (#13855) - Move the pip interface documentation into the concepts section (#13841)
- Remove the configuration section in favor of concepts / reference (#13842)
- Update Git and GitHub Actions docs to mention
gh auth login(#13850)
Preview
- Fix directory glob traversal fallback preventing exclusion of all files (#13882)
Install uv 0.7.12
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.12/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.12/uv-installer.ps1 | iex"Download uv 0.7.12
0.7.11
Release Notes
Python
- Add Python 3.14.0b1
- Add Python 3.13.4
- Add Python 3.12.11
- Add Python 3.11.13
- Add Python 3.10.18
- Add Python 3.9.23
Enhancements
- Add Pyodide support (#12731)
- Better error message for version specifier with missing operator (#13803)
Bug fixes
- Downgrade
reqwestandhyper-utilto resolve connection reset errors over IPv6 (#13835) - Prefer
uv's binary's version when checking if it's up to date (#13840)
Documentation
- Use "terminal driver" instead of "shell" in
SIGINTdocs (#13787)
Install uv 0.7.11
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.11/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.11/uv-installer.ps1 | iex"Download uv 0.7.11
0.7.10
Release Notes
Enhancements
- Add
--show-extrastouv tool list(#13783) - Add dynamically generated sysconfig replacement mappings (#13441)
- Add data locations to install wheel logs (#13797)
Bug fixes
- Avoid redaction of placeholder
gitusername when using SSH authentication (#13799) - Propagate credentials to files on devpi indexes ending in
/+simple(#13743) - Restore retention of credentials for direct URLs in
uv export(#13809)
Install uv 0.7.10
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.10/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.10/uv-installer.ps1 | iex"