Release Notes

Bug fixes

• Apply build constraints when resolving --with dependencies (#14340)
• Drop trailing slashes when converting index URL from URL (#14346)
• Ignore UV_PYTHON_CACHE_DIR when empty (#14336)
• Fix error message ordering for pyvenv.cfg version 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 | sh

Install 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

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 /simple component (#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 | sh

Install 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

Release Notes

Enhancements

• Consistently use Ordering::Relaxed for 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.json descriptions (#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 | sh

Install 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

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_machine marker for win_amd64 platform 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-groups from 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 | sh

Install 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

Release Notes

Python

• Add Python 3.14.0b2
• Add Python 3.13.5
• Fix stability of uuid.getnode on 3.13

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

Enhancements

• Download versions in uv python pin if 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 zstd and deflate to Accept-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.txt to 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 | sh

Install 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

Release Notes

Enhancements

• Add uv python pin --rm to remove .python-version pins (#13860)
• Don't hint at versions removed by excluded-newer (#13884)
• Add hint to use tool.uv.environments on resolution error (#13455)
• Add hint to use tool.uv.required-environments on resolution error (#13575)
• Improve python pin error messages (#13862)

Bug fixes

• Lock environments during uv sync, uv add and uv remove to prevent race conditions (#13869)
• Add --no-editable to uv export for pylock.toml (#13852)

Documentation

• List .gitignore in 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 | sh

Install 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

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 reqwest and hyper-util to 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 SIGINT docs (#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 | sh

Install 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

Release Notes

Enhancements

• Add --show-extras to uv tool list (#13783)
• Add dynamically generated sysconfig replacement mappings (#13441)
• Add data locations to install wheel logs (#13797)

Bug fixes

• Avoid redaction of placeholder git username 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 | sh

Install 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"

Download uv 0.7.10

Release Notes

Python

The changes reverted in 0.7.8 have been restored.

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

Enhancements

• Improve obfuscation of credentials in URLs (#13560)
• Allow running non-default Python implementations via uvx (#13583)
• Add uvw as alias for uv without console window on Windows (#11786)
• Allow discovery of x86-64 managed Python builds on macOS (#13722)
• Differentiate between implicit vs explicit architecture requests (#13723)
• Implement ordering for Python architectures to prefer native installations (#13709)
• Only show the first match per platform (and architecture) by default in uv python list (#13721)
• Write the path of the parent environment to an extends-environment key in the pyvenv.cfg file of an ephemeral environment (#13598)
• Improve the error message when libc cannot be found, e.g., when using the distroless containers (#13549)

Performance

• Avoid rendering info log level (#13642)
• Improve performance of uv-python crate's manylinux submodule (#11131)
• Optimize Version display (#13643)
• Reduce number of reference-checks for uv cache clean (#13669)

Bug fixes

• Avoid reinstalling dependency group members with --all-packages (#13678)
• Don't fail direct URL hash checking with dependency metadata (#13736)
• Exit early on self update if global --offline is set (#13663)
• Fix cases where the uv lock is incorrectly marked as out of date (#13635)
• Include pre-release versions in uv python install --reinstall (#13645)
• Set LC_ALL=C for git when checking git worktree (#13637)
• Avoid rejecting Windows paths for remote Python download JSON targets (#13625)

Preview

• Add uv add --bounds to configure version constraints (#12946)

Documentation

• Add documentation about Python versions to Tools concept page (#7673)
• Add example of enabling Dependabot (#13692)
• Fix exclude-newer date format for persistent configuration files (#13706)
• Quote versions variables in GitLab documentation (#13679)
• Update Dependabot support status (#13690)
• Explicitly specify to add a new repo entry to the repos list item in the .pre-commit-config.yaml (#10243)
• Add integration with marimo guide (#13691)
• Add pronunciation to README (#5336)

Install uv 0.7.9

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.9/uv-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.9/uv-installer.ps1 | iex"

Download uv 0.7.9

Release Notes

Python

We are reverting most of our Python changes from uv 0.7.6 and uv 0.7.7 due to
a miscompilation that makes the Python interpreter behave incorrectly, resulting
in spurious type-errors involving str. This issue seems to be isolated to
x86_64 Linux, and affected at least Python 3.12, 3.13, and 3.14.

The following changes that were introduced in those versions of uv are temporarily
being reverted while we test and deploy a proper fix for the miscompilation:

• Add Python 3.14 on musl
• free-threaded Python on musl
• Add Python 3.14.0a7
• Statically link libpython into the interpreter on Linux for a significant performance boost

See the issue for details.

Documentation

• Remove misleading line in pin documentation (#13611)

Install uv 0.7.8

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.8/uv-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.8/uv-installer.ps1 | iex"

Download uv 0.7.8