NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #850 most downloaded on PyPI
The uv build backend
Latest stable
0.13.9
Last release 3 days ago
17 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
175 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
This release contains various changes that improve correctness and user experience, but could break some workflows; many changes have been marked as b
This release contains various changes that improve correctness and user experience, but could break some workflows; many changes have been marked as breaking out of an abundance of caution. We expect most users to be able to upgrade without making changes.
Update uv version to display and update project versions (#12349)
Previously, uv version displayed uv's version. Now, uv version will display or update the project's version. This interface was heavily requested and, after much consideration, we decided that transitioning the top-level command was the best option.
Here's a brief example:
$ uv init example
Initialized project `example` at `./example`
$ cd example
$ uv version
example 0.1.0
$ uv version --bump major
example 0.1.0 => 1.0.0
$ uv version --short
1.0.0
If used outside of a project, uv will fallback to showing its own version still:
$ uv version
warning: failed to read project: No `pyproject.toml` found in current directory or any parent directory
running `uv self version` for compatibility with old `uv version` command.
this fallback will be removed soon, pass `--preview` to make this an error.
uv 0.7.0 (4433f41c9 2025-04-29)
As described in the warning, --preview can be used to error instead:
$ uv version --preview
error: No `pyproject.toml` found in current directory or any parent directory
The previous functionality of uv version was moved to uv self version.
Avoid fallback to subsequent indexes on authentication failure (#12805)
When using the first-index strategy (the default), uv will stop searching indexes for a package once it is found on a single index. Previously, uv considered a package as "missing" from an index during authentication failures, such as an HTTP 401 or HTTP 403 (normally, missing packages are represented by an HTTP 404). This behavior was motivated by unusual responses from some package indexes, but reduces the safety of uv's index strategy when authentication fails. Now, uv will consider an authentication failure as a stop-point when searching for a package across indexes. The index.ignore-error-codes option can be used to recover the existing behavior, e.g.:
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
ignore-error-codes = [401, 403]
Since PyTorch's indexes always return a HTTP 403 for missing packages, uv special-cases indexes on the pytorch.org domain to ignore that error code by default.
Require the command in uvx <name> to be available in the Python environment (#11603)
Previously, uvx would attempt to execute a command even if it was not provided by a Python package. For example, if we presume foo is an empty Python package which provides no command, uvx foo would invoke the foo command on the PATH (if present). Now, uv will error early if the foo executable is not provided by the requested Python package. This check is not enforced when --from is used, so patterns like uvx --from foo bash -c "..." are still valid. uv also still allows uvx foo where the foo executable is provided by a dependency of foo instead of foo itself, as this is fairly common for packages which depend on a dedicated package for their command-line interface.
Use index URL instead of package URL for keyring credential lookups (#12651)
When determining credentials for querying a package URL, uv previously sent the full URL to the keyring command. However, some keyring plugins expect to receive the index URL (which is usually a parent of the package URL). Now, uv requests credentials for the index URL instead. This behavior matches pip.
Remove --version from subcommands (#13108)
Previously, uv allowed the --version flag on arbitrary subcommands, e.g., uv run --version. However, the --version flag is useful for other operations since uv is a package manager. Consequently, we've removed the --version flag from subcommands — it is only available as uv --version.
Omit Python 3.7 downloads from managed versions (#13022)
Python 3.7 is EOL and not formally supported by uv; however, Python 3.7 was previously available for download on a subset of platforms.
Reject non-PEP 751 TOML files in install, compile, and export commands (#13120, #13119)
Previously, uv treated arbitrary .toml files passed to commands (e.g., uv pip install -r foo.toml or uv pip compile -o foo.toml) as requirements.txt-formatted files. Now, uv will error instead. If using PEP 751 lockfiles, use the standardized format for custom names instead, e.g., pylock.foo.toml.
Ignore arbitrary Python requests in version files (#12909)
uv allows arbitrary strings to be used for Python version requests, in which they are treated as an executable name to search for in the PATH. However, using this form of request in .python-version files is non-standard and conflicts with pyenv-virtualenv which writes environment names to .python-version files. In this release, uv will now ignore requests that are arbitrary strings when found in .python-version files.
Error on unknown dependency object specifiers (12811)
The [dependency-groups] entries can include "object specifiers", e.g. set-phasers-to = ... in:
[dependency-groups]
foo = ["pyparsing"]
bar = [{set-phasers-to = "stun"}]
However, the only current spec-compliant object specifier is include-group. Previously, uv would ignore unknown object specifiers. Now, uv will error.
Make --frozen and --no-sources conflicting options (#12671)
Using --no-sources always requires a new resolution and --frozen will always fail when used with it. Now, this conflict is encoded in the CLI options for clarity.
Treat empty UV_PYTHON_INSTALL_DIR and UV_TOOL_DIR as unset (#12907, #12905)
Previously, these variables were treated as set to the current working directory when set to an empty string. Now, uv will ignore these variables when empty. This matches uv's behavior for other environment variables which configure directories.
poetry-core as a uv init build backend option (#12781)pylock.toml (#13136)pyvenv.cfg version mismatch (#13027)pylock.toml (#13132)uvx --version (#13109)--no-binary et al) in pylock.toml (#13134)upload-time rather than upload_time in uv.lock (#13176)fish completions append >> to overwrite > (#13130)pylock.toml mentions where relevant (#13115)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.7.0/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.7.0/uv-installer.ps1 | iex"
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add PyTorch v2.7.0 to GPU backend
python (#13051)requires-python even if not listed on the index page (#13086)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.17/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.17/uv-installer.ps1 | iex"
Revert "Properly handle authentication for 302 redirect URLs"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.16/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.16/uv-installer.ps1 | iex"
This release includes preliminary support for the pylock.toml file format, as standardized in PEP 751. pylock.toml is an alternative resolution output
This release includes preliminary support for the pylock.toml file format, as standardized in PEP 751. pylock.toml is an alternative resolution output format intended to replace requirements.txt (e.g., in the context of uv pip compile, whereby a "locked" requirements.txt file is generated from a set of input requirements). pylock.toml is standardized and tool-agnostic, such that in the future, pylock.toml files generated by uv could be installed by other tools, and vice versa.
As of this release, pylock.toml is supported in the following commands:
uv.lock to the pylock.toml format, run: uv export -o pylock.tomlpylock.toml file from a set of requirements, run: uv pip compile -o pylock.toml requirements.inpylock.toml file, run: uv pip sync pylock.toml or uv pip install -r pylock.tomluv pip compile (#13019)uv export support for PEP 751 (#12955)requirements.txt (verbatim) as a format on the CLI (#12957)UV_NO_EDITABLE environment variable to set --no-editable on all invocations (#12773)pylock.toml to uv pip install and uv pip sync (#12992)SIGINT to child processes (#13018)uv.lock (#12968)which git in uv init (#12893)--dry-run with --locked / --frozen for uv sync (#12778)uv export (#12958)uv init resilient against broken git (#12895)uv run --with dependencies (#12882)uv tool and PEP723 scripts. (#12842)uvx binary when searching for uv binary (#12923)SourceNotAllowed error message during Python discovery (#13012)config-settings with example in docs (#12947)PythonDownloadRequest parsing for partial keys (#12925)uv-pep440 (#12836)uv run (#13017)CC and CCX entries in sysconfig for cross-compiled aarch64 Python distributions (#12239)UV_STACK_SIZE (#12839)uv python list (#12915)subdirectory to Direct URL for local directories (#12971)uv python install (#12194)uv init (#12870)uv python list --only-downloads and --only-installed (#12916)--locked to uv sync in GitHub Actions guide (#12819)"all" default-groups setting documentation (#12963)--frozen with --locked in Docker integration guide (#12818)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.15/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.15/uv-installer.ps1 | iex"
The following Python versions have been added:
The following Python versions have been added:
See the python-build-standalone release notes for more details.
uv-build and uv_build aliases to uv init --build-backend (#12776)environment.yml files (#12669)tool.uv.sources is set in system-level configuration file (#12757)uv init (#12756)uv pip sync (#12683)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.14/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.14/uv-installer.ps1 | iex"
Add --show-version to uv python find
--show-version to uv python find (#12376)--no-config warning from uv pip compile and uv pip sync (#12642)PATH when searching for Python interpreters (#12367)SCRIPT_PATH in relocatable activation script (#12672)UV_PYTHON_DOWNLOADS_JSON_URL to set custom managed python sources (#10939)pyproject.toml files in uv pip compile -o (#12673)--offline flag for Git operations (#12619)uv export with conflicts (#12726)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.13/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.13/uv-installer.ps1 | iex"
Report the queried executable path in uv python list
uv python list (#12628)authenticate when using explicit = true (#12631)uv add and uv remove (#12586)python-platform in settings files (#12592)uv build to package = false (#12608)authenticate = always documentation (#12498)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.12/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.12/uv-installer.ps1 | iex"
Add dependents ("via ..." comments) in uv export command
uv export command (#12350)--find-links-style "flat" indexes in [[tool.uv.index]] (#12407)-q and -qq (#12300)UV_PROJECT environment to set project directory. (#12327)requires-python to script blocks (#12517)uv sync (#12502)uv tree --only-group (#12560)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.11/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.11/uv-installer.ps1 | iex"
Add support for Python version requests in uv python list
uv sync --check flag (#12342)uv python list (#12375).env files in uv tool run (#12386)python find --script (#11891)--torch-backend is enabled (#12385)--no-build (#12314)--find-links entries for pinned indexes (#12396)--exclude-newer (#12299)requirements.txt (#12354)pip commands (#12470)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.10/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.10/uv-installer.ps1 | iex"
Use keyring --mode creds when authenticate = "always"
keyring --mode creds when authenticate = "always" (#12316)authenticate = "always" (#12313)UV_MANAGED_PYTHON flags (#12345)--torch-backend to the PyTorch guide (#12317)#keyring-provider references in alternative index docs (#12315)--directory path in examples (#12165)--torch-backend=auto (#12070)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.9/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.9/uv-installer.ps1 | iex"
Add support for enabling all groups by default with default-groups = "all"
default-groups = "all" (#12289)--managed-python and --no-managed-python flags for toggling Python preferences (#12246)requires-python (#12278)Planner::build (#12281)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.8/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.8/uv-installer.ps1 | iex"
_If encountering inconsistent wheel version errors, see https://github.com/astral-sh/uv/issues/12254_.
If encountering inconsistent wheel version errors, see https://github.com/astral-sh/uv/issues/12254.
CXX compiler on LinuxSee the python-build-standalone release notes for more details.
-c constraints in uv add (#12209)--global default version in uv python pin (#12115)uv pip install (#12176)--group flag to uv pip install and uv pip compile (#11686)File struct (#12159)src to default cache keys (#12062)python pin --global creates parent directories if missing (#12180)uv sync --script (#12158)activate.bat output (#12160)BaseClientBuild to accept custom proxies (#12232)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.7/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.7/uv-installer.ps1 | iex"
Add support for dynamic musl Python distributions on x86-64 Linux
See the python-build-standalone release notes for more details.
--marker flag to uv add (#12012)[index].authenticate allowing authentication to be required on an index (#11896)uv tool run (#12079)include-group (#12005)uv add failed (#12106)uv-auth (#12077)PATH updated when the export is commented in the shellrc (#12043)uv publish retry on network failures (#12041)uv publish to comply with WSGI PyPI server constraints (#12111)uv python install --reinstall when the version was not previously installed (#12124)uv_build invocation (#12058)python-versions.md (#12112)[index].authenticate docs (#12102)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.6/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.6/uv-installer.ps1 | iex"
Allow quotes around command-line options in requirement.txt files
requirement.txt files (#11644)uv lock --script (#11717).env files in UV_ENV_FILE (#11665)SmallString on Hashes (#11756)Box for Yanked on File (#11755)SmallString for the Yanked enum (#11715)uv add (#11716)uv export (#11643)uv build (#11593)cache-keys setting (#11669)curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/uv/releases/download/0.6.3/uv-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/uv/releases/download/0.6.3/uv-installer.ps1 | iex"
Nothing published for this version
One column per month.