Releases: astral-sh/uv
Releases · astral-sh/uv
0.8.18
Release Notes
Released on 2025-09-17.
Enhancements
- Add PyG packages to torch backend (#15911)
- Add handling for unnamed conda environments in base environment detection (#15681)
- Allow selection of debug build interpreters (#11520)
- Improve
uv initdefaults for native build backend cache keys (#15705) - Error when
pyproject.tomltarget does not exist for dependency groups (#15831) - Infer check URL from publish URL when known (#15886)
- Support Gitlab CI/CD as a trusted publisher (#15583)
- Add GraalPy 25.0.0 with support for Python 3.12 (#15900)
- Add
--no-cleartouv venvto disable removal prompts (#15795) - Add conflict detection between
--only-groupand--extraflags (#15788) - Allow
[project]to be missing from apyproject.toml(#14113) - Always treat conda environments named
baseandrootas base environments (#15682) - Improve log message when direct build for
uv_buildis skipped (#15898) - Log when the cache is disabled (#15828)
- Show pyx organization name after authenticating (#15823)
- Use
_CONDA_ROOTto detect Conda base environments (#15680) - Include blake2b hash in
uv publishupload form (#15794) - Fix misleading debug message when removing environments in
uv sync(#15881)
Deprecations
- Deprecate
tool.uv.dev-dependencies(#15469) - Revert "feat(ci): build loongarch64 binaries in CI (#15387)" (#15820)
Preview features
- Propagate preview flag to client for
native-authfeature (#15872) - Store native credentials for realms with the https scheme stripped (#15879)
- Use the root index URL when retrieving credentials from the native store (#15873)
Bug fixes
- Fix
uv sync --no-sourcesnot switching from editable to registry installations (#15234) - Avoid display of an empty string when a path is the working directory (#15897)
- Allow cached environment reuse with
@latest(#15827) - Allow escaping spaces in --env-file handling (#15815)
- Avoid ANSI codes in debug! messages (#15843)
- Improve BSD tag construction (#15829)
- Include SHA when listing lockfile changes (#15817)
- Invert the logic for determining if a path is a base conda environment (#15679)
- Load credentials for explicit members when lowering (#15844)
- Re-add
tritonas a torch backend package (#15910) - Respect
UV_INSECURE_NO_ZIP_VALIDATION=1in duplicate header errors (#15912)
Documentation
- Add GitHub Actions to PyPI trusted publishing example (#15753)
- Add Coiled integration documentation (#14430)
- Add verbose output to the getting help section (#15915)
- Document
NO_PROXYsupport (#15816) - Document cache-keys for native build backends (#15811)
- Add documentation for dependency group
requires-python(#14282)
Install uv 0.8.18
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.18/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.18/uv-installer.ps1 | iex"Download uv 0.8.18
0.8.17
Release Notes
Released on 2025-09-10.
Enhancements
- Improve error message for HTTP validation in auth services (#15768)
- Respect
PYX_API_URLwhen suggestinguv auth loginon 401 (#15774) - Add pyx as a supported PyTorch index URL (#15769)
Bug fixes
- Avoid initiating login flow for invalid API keys (#15773)
- Do not search for a password for requests with a token attached already (#15772)
- Filter pre-release Python versions in
uv init --script(#15747)
Install uv 0.8.17
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.17/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.17/uv-installer.ps1 | iex"Download uv 0.8.17
0.8.16
Release Notes
Due to a bug in the release process for the new loongarch64 support (see #15762), this release was partially published and manually finished. Consequently, the uv_build artifacts were uploaded to PyPI with a PAT instead of via OIDC and the GitHub Release was published by a maintainer instead of GitHub Actions. The artifacts from GitHub Actions were used without alteration. The uv artifacts were not affected. There should be no consequences from this; we just want to be transparent about the provenance of the artifacts.
Enhancements
- Allow
--editableto overrideeditable = falseannotations (#15712) - Allow
editable = falsefor workspace sources (#15708) - Show a dedicated error for virtual environments in source trees on build (#15748)
- Support Android platform tags (#15646)
- Support iOS platform tags (#15640)
- Support scripts with inline metadata in
--with-requirementsand--requirements(#12763)
Preview features
Bug fixes
- Avoid erroring when
match-runtimetarget is optional (#15671) - Ban empty usernames and passwords in
uv auth(#15743) - Error early for parent path in build backend (#15733)
- Retry on IO errors during HTTP/2 streaming (#15675)
- Support recursive requirements and constraints inclusion (#15657)
- Use token store credentials for
uv publish(#15759) - Fix virtual environment activation script compatibility with latest nushell (#15272)
- Skip Python interpreters that cannot be queried with permission errors (#15685)
Documentation
- Clarify that
uv authcommands take a URL (#15664) - Improve the CLI help for options that accept requirements files (#15706)
- Adds example for caching for managed Python downloads in Docker builds (#15689)
Install uv 0.8.16
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.16/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.16/uv-installer.ps1 | iex"Download uv 0.8.16
0.8.15
Release Notes
Python
- Upgrade SQLite 3.50.4 in CPython builds for CVE-2025-6965 (see also python/cpython#137134)
Enhancements
- Add
uv authcommands for credential management (#15570) - Add pyx support to
uv authcommands (#15636) - Add
uv tree --show-sizesto show package sizes (#15531) - Add
--python-platform riscv64-unknown-linux(#15630) - Add
--python-platformtouv runanduv tool(#15515) - Add
uv publish --dry-run(#15638) - Add zstandard support for wheels (#15645)
- Allow registries to pre-provide core metadata (#15644)
- Retry streaming Python and binary download errors (#15567)
Bug fixes
- Fix settings rendering for
extra-build-dependencies(#15622) - Skip non-existent directories in bytecode compilation (#15608)
Error messages
- Add error trace to invalid package format (#15626)
Install uv 0.8.15
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.15/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.15/uv-installer.ps1 | iex"Download uv 0.8.15
0.8.14
Release Notes
Python
- Add managed CPython distributions for aarch64 musl
Enhancements
- Add
--python-platformtouv pip check(#15486) - Add an environment variable for
UV_ISOLATED(#15428) - Add logging to the uv build backend (#15533)
- Allow more trailing null bytes in zip files (#15452)
- Allow pinning managed Python versions to specific build versions (#15314)
- Cache PyTorch wheels by default (#15481)
- Reject already-installed wheels that don't match the target platform (#15484)
- Add
--no-install-localoption touv sync,uv addanduv export(#15328) - Include cycle error message in
uv pipCLI (#15453)
Preview features
- Fix format of
{version}onuv formatfailure (#15527) - Lock during installs in
uv formatto prevent races (#15551) - Respect
--projectinuv format(#15438) - Run
uv formatin the project root (#15440)
Configuration
- Add file-to-CLI overrides for build isolation configuration (#15437)
- Add file-to-CLI overrides for reinstall configuration (#15426)
Performance
- Cache
WHEELandMETADATAreads in installed distributions (#15489)
Bug fixes
- Avoid erroring when creating
venvin current working directory (#15537) - Avoid introducing unnecessary system dependency on CUDA (#15449)
- Clear discovered site packages when creating virtual environment (#15522)
- Read index credentials from the environment during
uv publishchecks (#15545) - Refuse to remove non-virtual environments in
uv venv(#15538) - Stop setting
CLICOLOR_FORCE=1when calling build backends (#15472) - Support file or directory removal for Windows symlinks (#15543)
Documentation
- Fix GitHub guide highlight lines (#15443)
- Move Resolver to new Internals section in the Reference (#15465)
- Split the "Authentication" page into sections (#15575)
- Update uninstall docs to mention
uvw.exeneeds to be removed (#15536)
Install uv 0.8.14
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.14/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.14/uv-installer.ps1 | iex"Download uv 0.8.14
0.8.13
Release Notes
Enhancements
- Add
--no-install-*arguments touv add(#15375) - Initialize Git prior to reading author in
uv init(#15377) - Add CUDA 129 to available torch backends (#15416)
- Update Pyodide to 0.28.2 (#15385)
Preview features
- Add an experimental
uv formatcommand (#15017) - Allow version specifiers in
extra-build-dependenciesif match-runtime is explicitlyfalse(#15420)
Bug fixes
- Add
tritontotorch-backendmanifest (#15405) - Avoid panicking when resolver returns stale distributions (#15389)
- Fix
uv_buildwheel hashes (#15400) - Treat
--upgrade-packageon the command-line as overridingupgrade = falsein configuration (#15395) - Restore DockerHub publishing (#15381)
Install uv 0.8.13
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.13/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.13/uv-installer.ps1 | iex"Download uv 0.8.13
0.8.12
Release Notes
Python
- Add 3.13.7
- Improve performance of zstd in Python 3.14
See the python-build-standalone release notes for details.
Enhancements
- Add an
aarch64-pc-windows-msvctarget forpython-platform(#15347) - Add fallback parent process detection to
uv tool update-shell(#15356) - Install non-build-isolation packages in a second phase (#15306)
- Add hint when virtual environments are included in source distributions (#15202)
- Add Docker images derived from
buildpack-deps:trixie,debian:trixie-slim,alpine:3.22(#15351)
Bug fixes
- Reject already-installed wheels built with outdated settings (#15289)
- Skip interpreters that are not found on query (#15315)
- Handle dotted package names in script path resolution (#15300)
- Reject
match-runtime = truefor dynamic packages (#15292)
Documentation
- Document improvements to build-isolation setups (#15326)
- Fix reference documentation recommendation to use
uv cache cleaninstead ofclear(#15313)
Install uv 0.8.12
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.12/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.12/uv-installer.ps1 | iex"Download uv 0.8.12
0.8.11
Release Notes
Python
- Add Python 3.14.0rc2
- Update Pyodide to 0.28.1
Enhancements
- Add Debian 13 trixie to published Docker images (#15269)
- Add
extra-build-dependencieshint for any missing module on build failure (#15252) - Make 'v' prefix cyan in overlap warnings (#15259)
Bug fixes
- Fix missing uv version in extended Docker image tags (#15263)
- Persist cache info when re-installing cached wheels (#15274)
Rust API
- Allow passing custom
reqwestclients toRegistryClient(#15281)
Install uv 0.8.11
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.11/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.11/uv-installer.ps1 | iex"Download uv 0.8.11
0.8.10
Release Notes
Python
- Add support for installing Pyodide versions (#14518)
Enhancements
- Allow Python requests with missing segments, e.g., just
aarch64(#14399)
Preview
- Move warnings for conflicting modules into preview (#15253)
Install uv 0.8.10
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.10/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.10/uv-installer.ps1 | iex"Download uv 0.8.10
0.8.9
Release Notes
Enhancements
- Add
--reinstallflag touv python upgrade(#15194)
Bug fixes
- Include build settings in cache key for registry source distribution lookups (#15225)
- Avoid creating bin links on
uv python upgradeif they don't already exist (#15192) - Respect system proxies on macOS and Windows (#15221)
Documentation
- Add the 3.14 classifier (#15187)
Install uv 0.8.9
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.8.9/uv-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.8.9/uv-installer.ps1 | iex"