Change8

uv

Dev Tools

An extremely fast Python package and project manager, written in Rust.

Latest: 0.10.7100 releases10 breaking changes5 common errorsView on GitHub

Release History

0.10.71 fix1 feature
Feb 27, 2026

Version 0.10.7 fixes a bug related to Windows Container junctions and introduces activation of logging for middleware retries. This release also details various prebuilt binary downloads and artifact attestation verification instructions.

0.10.63 fixes
Feb 25, 2026

This release (0.10.6) focuses on bug fixes, including resolving Python version selection conflicts and ensuring file permission preservation on Linux during reflinks. Documentation for optional dependencies was also cleaned up.

0.10.57 fixes6 features
Feb 24, 2026

This release introduces several enhancements related to configuration hints, locking behavior, and file linking strategies, alongside numerous bug fixes for workspace operations, environment variable handling, and platform detection. The performance of handling repeated conflicts has also been improved.

0.10.43 fixes1 feature
Feb 17, 2026

This release focuses on stability, fixing a panic during filesystem root initialization and resolving permission issues with built artifacts, alongside improving error reporting and skipping git-ignored workspace members during discovery.

0.10.35 fixes4 features
Feb 16, 2026

This release introduces support for CPython 3.15.0a6 and includes several enhancements like improved error consistency on Windows and fixes for version matching and panics.

0.10.21 fix
Feb 10, 2026

This release deprecates the use of unexpected ZIP compression methods and fixes a bug where `cargo-install` would fail due to a missing dependency.

0.10.13 fixes
Feb 10, 2026

Version 0.10.1 improves robustness by preventing panics on metadata read errors and skipping empty workspace members. It also updates documentation suggestions for shell updates.

0.10.0Breaking1 fix4 features
Feb 5, 2026

This release stabilizes several preview features, including Python version management and workspace utilities, while introducing several breaking changes to improve correctness, such as requiring explicit confirmation for venv removal and stricter index configuration validation.

0.9.302 fixes4 features
Feb 4, 2026

This release introduces support for newer Python versions (3.14.3, 3.13.12) and enhances the `uv publish` command by allowing comma-separated values for the --extra option and fixing a deadlock bug. Virtual environments are now relocatable by default as a preview feature.

0.9.295 fixes7 features
Feb 3, 2026

This release updates the Python environment to Pyodide 0.29.3 and introduces several enhancements related to platform naming, publishing, and error handling. Several bugs related to Python inheritance, wheel rejection, and sandboxing have also been fixed.

0.9.281 fix3 features
Jan 29, 2026

This release updates the underlying CPython build to use OpenSSL 3.5.5 for security fixes and introduces Windows support for the Pyodide interpreter.

0.9.272 fixes5 features
Jan 26, 2026

This release updates core dependencies like Pyodide and GraalPy, introduces new features such as `--exclude` for `uv pip freeze` and ROCm 7.x support, and improves error handling for ABI incompatibilities.

0.9.261 fix5 features
Jan 15, 2026

This release introduces support for CPython 3.15.0a5 and adds several usability enhancements, including better error messaging and support for `--no-sources-package`. A critical bug fix addresses concurrent token refreshing.

0.9.255 fixes6 features
Jan 13, 2026

This release introduces support for CPython 3.15.0a4 and upgrades the bundled Tcl/Tk to version 9.0. New features include bytecode compilation flags for installation and per-package control over `exclude-newer`.

0.9.24
Jan 9, 2026
0.9.23
Jan 9, 2026
0.9.222 fixes1 feature
Jan 6, 2026

uv 0.9.22 adds a dedicated error message for missing lockfiles, filters unusable wheels for more architectures, improves retry counting, and clarifies the requirements file format.

0.9.211 fix
Dec 30, 2025

This release fixes a regression regarding zstd distribution hash validation and addresses typos in the documentation for resolution and Python installation.

0.9.206 fixes7 features
Dec 29, 2025

Release 0.9.20 is a re-release of 0.9.19 that fixes publishing issues and introduces CPython 3.15.0a3 support, enhanced interpreter handling in 'uv pip compile', and various bug fixes for Git URLs and pip constraints.

0.9.187 fixes6 features
Dec 16, 2025

uv 0.9.18 introduces performance improvements for cache sizing and S3 signing, adds support for torch-backend configuration, and fixes several bugs including macOS ExFAT file locking and panics on failed requests.

0.9.171 fix4 features
Dec 9, 2025

uv 0.9.17 introduces support for relative durations in dependency cooldowns, adds new PyTorch-related packages, and improves Nushell activation scripts and CLI hints.

0.9.16Breaking4 fixes8 features
Dec 6, 2025

This release introduces support for new CPython versions, adds a Bazel auth helper, and implements a 5-minute timeout for file locks to prevent deadlocks. It also includes several CLI enhancements for 'uv pip' and 'uv add', alongside performance improvements in HTML parsing.

0.9.154 fixes8 features
Dec 3, 2025

uv 0.9.15 adds support for CPython 3.14.1 and ROCm 6.4, while fixing a metadata retrieval hang by reverting astral-tl. The release process was modified to bypass PEP 740 attestation issues on PyPI.

0.9.143 fixes3 features
Dec 1, 2025

uv 0.9.14 introduces performance improvements via SIMD HTML parsing and several bug fixes for shell integration and dependency management. It also standardizes the working directory environment variable to UV_WORKING_DIR.

0.9.132 fixes
Nov 26, 2025

uv 0.9.13 is a maintenance release focused on bug fixes for requirements file streaming and wheel tag validation, alongside documentation improvements.

0.9.123 features
Nov 25, 2025

This release introduces PEP 740 attestation support for publishing and improves script metadata handling, alongside significant documentation updates for crates.io and Docker workspaces.

0.9.115 fixes4 features
Nov 20, 2025

uv 0.9.11 introduces SBOM support for exports, adds CPython 3.15.0a2, and includes several fixes for TOML serialization and workspace commands.

0.9.10Breaking2 fixes6 features
Nov 17, 2025

This release introduces workspace listing and Python upgrade capabilities, improves SSL and license file handling, and enables automatic Python installation for targeted pip installs.

0.9.9Breaking2 fixes9 features
Nov 12, 2025

uv 0.9.9 introduces iOS interpreter discovery, new workspace commands, and several enhancements while deprecating the `--project` flag and removing built‑in torch‑model‑archiver packages, requiring minimal migration steps.

0.9.87 fixes8 features
Nov 7, 2025

uv 0.9.8 introduces multi-package support for export/sync, a new cache size command, and dependency exclusions, alongside critical bug fixes for Docker DNS and GPU detection.

0.9.72 fixes2 features
Oct 30, 2025

uv 0.9.7 introduces Windows x86-32 emulation support and UI improvements to progress bars, while fixing issues with terminal coloring in auth tokens and flag behavior.

0.9.69 fixes5 features
Oct 29, 2025

This release focuses on security by addressing ZIP parsing differentials and adds several enhancements to 'uv build' and 'uv init', alongside various bug fixes for CLI commands.

0.9.52 fixes3 features
Oct 21, 2025

uv 0.9.5 upgrades the `astral-tokio-tar` dependency to 0.5.6 for security, adds helpful hints for environment markers and system‑managed interpreters, improves error messages, and fixes several bugs.

0.9.41 fix3 features
Oct 18, 2025

uv 0.9.4 adds CUDA 13.0 support, Intel GPU auto‑detection on Windows, and RFC 9457 error context display, while fixing token obfuscation in `uv auth token`. Upgrade via the new installer script or prebuilt binaries.

0.9.31 fix3 features
Oct 15, 2025

uv 0.9.3 introduces support for newer CPython releases, adds log obfuscation for secret tokens, and resolves a workspace relative‑path bug.

0.9.23 features
Oct 10, 2025

uv 0.9.2 adds support for newer CPython versions, improves uv publish handling of .pyx files, and introduces a --show-python option for uv tool list.

0.9.16 fixes4 features
Oct 9, 2025

uv 0.9.1 introduces several new configuration options and enhancements, plus a collection of bug fixes and documentation updates, while maintaining full compatibility with prior versions.

0.9.0Breaking5 fixes7 features
Oct 7, 2025

uv 0.9.0 switches the default Python version to 3.14, updates Docker images, and adds free‑threaded interpreter support, while fixing several build and upgrade bugs.

0.8.242 features
Oct 7, 2025

uv 0.8.24 introduces a new `--force` option for `uv cache prune` and adds informative messages when cache clean or prune commands encounter a held lock.

0.8.238 fixes2 features
Oct 4, 2025

uv 0.8.23 adds s390x build support, a new environment variable to skip wheel filename checks, numerous bug fixes, and expands platform coverage with Tier 2 support for Windows arm64 and Linux RISC‑V64.

0.8.22
Sep 23, 2025

uv 0.8.22 updates Pyodide to 0.28.3 and hardens tar extraction by upgrading astral-tokio-tar to 0.5.5, with new installer scripts and binary packages.

0.8.212 features
Sep 23, 2025

uv 0.8.21 introduces a `--refresh` flag to refresh lockfiles and adds preview support for S3 request signing.

0.8.202 fixes3 features
Sep 22, 2025

uv 0.8.20 adds a new `--force` flag for cache cleaning, improves proxied package resolution errors, and introduces a preview feature for upgrading pre‑release versions, while fixing Python list visibility and cache handling bugs.

0.8.192 fixes2 features
Sep 19, 2025

uv 0.8.19 introduces CPython 3.14.0rc3 support and updates OpenSSL to 3.5.3, plus bug fixes for parallel cache cleaning and Windows ARM64 platform tag handling.

0.8.1811 fixes20 features
Sep 17, 2025

uv 0.8.18 introduces numerous enhancements—including PyG torch backend support, GraalPy 25.0.0 for Python 3.12, improved conda detection, and new CLI flags—while deprecating `tool.uv.dev-dependencies` and fixing a range of bugs.

0.8.173 fixes3 features
Sep 10, 2025

uv 0.8.17 introduces improved auth error handling, support for PYX_API_URL and PyTorch index URLs, along with several bug fixes and updated prebuilt binaries.

0.8.168 fixes8 features
Sep 10, 2025

uv 0.8.16 introduces support for Android, iOS, and loongarch64 platforms, alongside enhancements to editable dependency handling and various bug fixes for authentication and build processes.

0.8.152 fixes10 features
Sep 3, 2025

uv 0.8.15 introduces several new commands and options, adds zstandard wheel support, improves error reporting, and includes bug fixes and security updates.

0.8.147 fixes12 features
Aug 28, 2025

uv 0.8.14 adds several new CLI flags, environment variable support, performance improvements, and numerous bug fixes while expanding managed CPython distributions.

0.8.135 fixes6 features
Aug 21, 2025

uv 0.8.13 adds new CLI options, CUDA 12.9 support, an experimental formatter, and several bug fixes while updating Pyodide and restoring DockerHub publishing.

0.8.124 fixes7 features
Aug 19, 2025

uv 0.8.12 adds support for Python 3.13.7, improves zstd performance in Python 3.14, introduces new platform targets, Docker images, and several usability enhancements while fixing a handful of bugs.

0.8.112 fixes6 features
Aug 14, 2025

uv 0.8.11 adds Python 3.14 support, Debian 13 Docker images, extra build dependency hints, custom reqwest client support in the Rust API, and includes several bug fixes and enhancements.

0.8.102 features
Aug 13, 2025

uv 0.8.10 adds Pyodide installation support and relaxes Python request segment requirements, with warnings for conflicting modules moved to preview.

0.8.93 fixes1 feature
Aug 12, 2025

uv 0.8.9 introduces a new `--reinstall` flag for `uv python upgrade` and includes several bug fixes such as improved cache key handling, correct bin link creation, and proxy support on macOS/Windows.

0.8.81 fix
Aug 9, 2025

uv 0.8.8 includes a bug fix improving find_uv_bin compatibility with Python <3.10.

0.8.74 fixes7 features
Aug 8, 2025

uv 0.8.7 adds several enhancements to `find_uv_bin`, introduces new environment variables, and fixes bugs around hash requirements and environment overlays, while deprecating the Tix extension on Linux.

0.8.6Breaking6 fixes8 features
Aug 7, 2025

uv 0.8.6 introduces strict ZIP validation to mitigate parser‑confusion attacks, adds CPython 3.13.6 support, per‑project build‑time env vars, and several bug fixes and enhancements.

0.8.59 fixes9 features
Aug 5, 2025

uv 0.8.5 adds several enhancements such as Gist support for `uv run`, improved caching logs, wheel tag hints, and extra executable installation, along with preview features for extra build dependencies. It also includes numerous bug fixes and updated documentation.

0.8.44 fixes7 features
Jul 30, 2025

uv 0.8.4 introduces several enhancements such as improved warning styling, expanded wheel filtering for Android, and new configuration options, along with preview support for extra build dependencies and split preview flags. It also fixes lockfile handling, entrypoint shebang copying, wheel permissions, and uv.toml validation.

0.8.35 fixes3 features
Jul 24, 2025

uv 0.8.3 adds CPython 3.14 rc1 support, allows custom entrypoint names in `uv_build`, and publishes riscv64 wheels, while fixing several credential and concurrency issues.

0.8.23 fixes3 features
Jul 22, 2025

uv 0.8.2 adds derivation chains for dependency errors, a new UV_INIT_BUILD_BACKEND env var, and exposes tls_built_in_root_certs, while fixing several bugs related to environment scanning, virtual environment cleanup, and pyproject.toml handling.

0.8.110 fixes12 features
Jul 22, 2025

uv 0.8.1 adds numerous enhancements such as HF_TOKEN support, new config‑settings handling, and Windows improvements, while fixing bugs around virtual environment removal and HTTP handling.

0.8.0Breaking1 feature
Jul 17, 2025

uv 0.7.x introduces stable Python executable installation, Windows Registry registration, safer venv removal, stricter interpreter preference enforcement, and automatic packaging of path and workspace dependencies, while updating the default manylinux target and removing the version fallback.

0.7.224 fixes7 features
Jul 17, 2025

uv 0.7.22 upgrades GraalPy, adds several new environment variables and preview features, and includes a handful of bug fixes and documentation updates.

0.7.211 fix10 features
Jul 14, 2025

uv 0.7.21 adds new CLI options, improves cache‑key handling, introduces a JSON output preview for sync, and fixes a Python‑version resolution bug.

0.7.204 fixes10 features
Jul 9, 2025

uv 0.7.20 adds new runtimes (Python 3.14 beta, PyPy 7.3.20), several CLI enhancements, Rust API improvements, and a handful of bug fixes.

0.7.192 fixes6 features
Jul 2, 2025

uv 0.7.19 stabilizes the uv_build backend, adds PGO‑optimized Python for aarch64 Linux, introduces several usability enhancements, and fixes lock handling and environment caching issues.

0.7.185 fixes6 features
Jul 1, 2025

uv 0.7.18 adds arm64 Windows Python 3.11‑3.14 binaries, several performance enhancements, a preview feature for build backends, and multiple bug fixes.

0.7.174 fixes
Jun 29, 2025

uv 0.7.17 is a bug‑fix release that improves dependency resolution, index URL handling, environment variable handling, and error message ordering.

0.7.166 fixes5 features
Jun 27, 2025

uv 0.7.16 adds Python 3.14 b3 support, improves lockfile error reporting, introduces workspace cache sharing, and includes several bug fixes and preview enhancements.

0.7.152 fixes5 features
Jun 25, 2025

uv 0.7.15 introduces several enhancements, a preview feature for symlink support in build backends, and fixes bugs related to Windows venv creation and source URL parsing.

0.7.1410 fixes10 features
Jun 23, 2025

uv 0.7.14 adds XPU and ROCm support to the torch backend, introduces dependency‑group Python version constraints, improves GPU auto‑detection and HTTP retry visibility, and includes a set of bug fixes and performance enhancements.

0.7.133 fixes9 features
Jun 12, 2025

uv 0.7.13 introduces new Python version support, several enhancements such as TTY‑based SIGINT handling and expanded Accept‑Encoding, builds for riscv64, and a set of bug fixes and documentation updates.

0.7.123 fixes5 features
Jun 6, 2025

uv 0.7.12 adds new pin removal, improved resolution hints, and several usability enhancements while fixing race conditions and export options.

0.7.112 fixes8 features
Jun 4, 2025

uv 0.7.11 adds Pyodide support, improves error messages, updates supported Python versions, and includes bug fixes for IPv6 connection resets and version checking.

0.7.103 fixes3 features
Jun 3, 2025

uv 0.7.10 introduces new `--show-extras` flag, sysconfig mapping enhancements, and wheel log location data, while fixing credential handling and SSH username redaction issues.

0.7.97 fixes14 features
May 30, 2025

uv 0.7.9 adds several enhancements such as improved credential obfuscation, support for non-default Python implementations via uvx, a new uvw alias, and architecture‑aware Python discovery, along with numerous bug fixes and a preview of `uv add --bounds`.

0.7.8Breaking2 fixes
May 24, 2025

uv 0.7.8 reverts recent Python‑related changes that caused miscompilation on x86_64 Linux and fixes a documentation issue.

0.7.72 fixes2 features
May 22, 2025

uv 0.7.7 adds a libpython linking workaround and enables experimental JIT on newer macOS aarch64 Python versions, plus bug fixes for `uv version` locking and diagnostic paths.

0.7.61 fix6 features
May 20, 2025

uv 0.7.6 adds Python 3.14 support (including musl and free‑threaded builds) and statically links libpython on Linux, while improving VIRTUAL_ENV_PROMPT handling and bumping the Rust MSRV to 1.85.

0.7.54 fixes
May 17, 2025

uv 0.7.5 introduces several bug fixes, including case-sensitive module discovery, a cache bucket update, improved script handling, and a typo correction, along with updated pre‑built binaries for multiple platforms.

0.7.48 fixes16 features
May 15, 2025

uv 0.7.4 adds numerous usability enhancements, a flag rename, improved error handling, and several bug fixes while introducing a preview build backend feature.

0.7.38 fixes12 features
May 7, 2025

uv 0.7.3 adds several enhancements such as dry‑run support for self‑update, new tool‑listing options, expanded zip compression, GraalPy downloads, and a configurable Python JSON source, along with preview build backend improvements and numerous bug fixes.

0.7.23 fixes3 features
Apr 30, 2025

uv 0.7.2 adds enhancements like improved trace logs for retryable errors and stricter error handling for version commands, and fixes bugs related to virtual environment invalidation, clang patching, and project flag handling.

0.7.11 fix1 feature
Apr 30, 2025

uv 0.7.1 adds BLAKE2b-256 support and reverts a previous authentication redirect fix.

0.7.0Breaking4 fixes5 features
Apr 29, 2025

This release introduces several breaking changes—most notably a new behavior for `uv version` and stricter validation for indexes and configuration—while adding useful enhancements such as a managed download cache and improved error hints.

0.6.176 fixes1 feature
Apr 25, 2025

uv 0.6.17 adds PyTorch v2.7.0 support for GPU backends and includes several stability fixes, with new installer scripts and prebuilt binaries for many platforms.

0.6.16Breaking1 fix
Apr 22, 2025

uv 0.6.16 fixes a regression by reverting the 302 redirect authentication handling, with no new features or deprecations.

0.6.1528 fixes20 features
Apr 22, 2025

This release adds preliminary support for the PEP 751 `pylock.toml` format across export, compile, install, and sync commands, introduces several new environment variables and enhancements, and includes numerous bug fixes and documentation updates.

0.6.142 fixes5 features
Apr 9, 2025

uv 0.6.14 introduces new `uv-build`/`uv_build` aliases, improved error handling for Conda files, preview build‑backend enhancements, and a performance tweak to reduce GitHub queries, while also fixing configuration and workspace formatting bugs.

0.6.132 fixes7 features
Apr 7, 2025

uv 0.6.13 introduces several new flags and environment variables, improves path handling and offline Git support, and fixes CRC warnings and an export loop, with no breaking changes.

0.6.124 fixes2 features
Apr 2, 2025

uv 0.6.12 adds enhancements for reporting the queried executable path and clearer archive unpack error messages, and includes bug fixes for authentication handling, dependency name normalization, CRC-32 enforcement, and settings parsing.

0.6.114 fixes6 features
Mar 30, 2025

uv 0.6.11 introduces new export dependents, support for UV_PROJECT, flat index handling, and performance improvements, while fixing several script and dependency handling bugs.

0.6.108 fixes5 features
Mar 26, 2025

uv 0.6.10 adds several new flags and environment support, introduces a preview torch index check, and includes numerous bug fixes and performance improvements.

0.6.93 fixes3 features
Mar 20, 2025

uv 0.6.9 adds keyring credential mode support, improved authentication error handling, and an experimental PyTorch backend inference feature, along with several bug fixes and documentation updates.

0.6.83 fixes3 features
Mar 18, 2025

uv 0.6.8 introduces default group enabling, new managed‑python flags, a cache‑allocation optimization, and several bug fixes.

0.6.79 fixes11 features
Mar 17, 2025

uv 0.6.7 introduces new constraint handling, global version pinning, a pip‑compatible group flag, preview enhancements, and updates the Rust `BaseClientBuild` API, while fixing numerous bugs and adding CPython 3.14 support.

0.6.65 fixes14 features
Mar 12, 2025

uv 0.6.6 adds dynamic musl Python support, a new `--marker` flag for `uv add`, JIT runtime enablement for Python 3.13/3.14, and numerous performance and usability improvements, while fixing several bugs in publishing and installation.

0.6.56 fixes10 features
Mar 6, 2025

uv 0.6.5 introduces several new command‑line options, environment variables, and performance improvements, along with bug fixes and a preview of a separate uv_build package.

0.6.414 fixes14 features
Mar 3, 2025

uv 0.6.4 adds pypy3.10 upgrade, CLI log verbosity, duplicate index warnings, numerous performance tweaks, and a wide range of bug fixes and documentation updates.

Common Errors

ModuleNotFoundError2 reports

The "ModuleNotFoundError" in uv usually arises when Python can't locate a required package, often due to an incorrect or unactivated virtual environment context. To fix it, ensure your virtual environment (created by uv venv) is activated using `source .venv/bin/activate` (or the appropriate activation script for your shell) before running your Python script or application. If the package is newly added, rebuilding your dependencies or clearing the uv cache might be necessary to update the environment's awareness of the installed package.

VirtualEnvError1 report

VirtualEnvError in uv often arises when uv attempts to operate outside its virtual environment or encounters inconsistencies within it, such as missing or corrupted files. To fix this, ensure that your shell is correctly activated within the virtual environment before running uv commands and verify the integrity of the virtual environment by recreating it if necessary, for example, using `python3 -m venv .venv && source .venv/bin/activate`.

LockedFileError1 report

LockedFileError in uv usually arises when a file is accessed or modified simultaneously by multiple processes or threads without proper synchronization. To fix this, ensure exclusive access to the file during critical operations using file locking mechanisms (e.g., `flock` or `fcntl`) or by coordinating file access across processes/threads with appropriate synchronization primitives like mutexes or semaphores. Specifically, review the code section raising the error, find all places that access the file, and add file locking around those regions to prevent concurrent access.

SetLastError1 report

The "SetLastError" error in uv typically arises when a function fails but its error code isn't properly propagated to the caller, leading to inaccurate error reporting. To fix this, ensure that every function call that can set an error also checks its return value and uses `SetLastError` with the appropriate error code before returning failure to propagate the error up the call stack effectively. Also, when consuming Windows APIs immediately check GetLastError and handle the error.

TomlCredentialError1 report

TomlCredentialError in uv usually arises from missing or malformed `pypirc` or `uv.toml` files that specify credentials for accessing package indexes. To fix, ensure these files exist in the correct location (e.g., `$HOME/.pypirc` or project root) and contain valid TOML syntax with properly configured credentials (username, password or token) for the relevant index URLs. Specifically, check for typos in section names like `[tool.uv]` or `[pypi]` and that the URL matches the expected pattern for your index.

Related Dev Tools Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed