uv
Dev ToolsAn extremely fast Python package and project manager, written in Rust.
Release History
0.10.71 fix1 featureVersion 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 fixesThis 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 featuresThis 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 featureThis 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 featuresThis 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 fixThis 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 fixesVersion 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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.240.9.230.9.222 fixes1 featureuv 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 fixThis release fixes a regression regarding zstd distribution hash validation and addresses typos in the documentation for resolution and Python installation.
0.9.206 fixes7 featuresRelease 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 featuresuv 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 featuresuv 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 featuresThis 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 featuresuv 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 featuresuv 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 fixesuv 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 featuresThis 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 featuresuv 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 featuresThis 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresThis 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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.22uv 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 featuresuv 0.8.21 introduces a `--refresh` flag to refresh lockfiles and adds preview support for S3 request signing.
0.8.202 fixes3 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featureuv 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 fixuv 0.8.8 includes a bug fix improving find_uv_bin compatibility with Python <3.10.
0.8.74 fixes7 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featureuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 fixesuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 fixesuv 0.7.8 reverts recent Python‑related changes that caused miscompilation on x86_64 Linux and fixes a documentation issue.
0.7.72 fixes2 featuresuv 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 featuresuv 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 fixesuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featureuv 0.7.1 adds BLAKE2b-256 support and reverts a previous authentication redirect fix.
0.7.0Breaking4 fixes5 featuresThis 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 featureuv 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 fixuv 0.6.16 fixes a regression by reverting the 302 redirect authentication handling, with no new features or deprecations.
0.6.1528 fixes20 featuresThis 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 0.6.8 introduces default group enabling, new managed‑python flags, a cache‑allocation optimization, and several bug fixes.
0.6.79 fixes11 featuresuv 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 featuresuv 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 featuresuv 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 featuresuv 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 reportsThe "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 reportVirtualEnvError 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 reportLockedFileError 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 reportThe "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 reportTomlCredentialError 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
Empowering everyone to build reliable and efficient software.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
Next generation frontend tooling. It's fast!
A bundler for javascript and friends. Packs many modules into a few bundled assets. Code Splitting allows for loading parts of the application on demand. Through "loaders", modules can be CommonJs, AMD, ES6 modules, CSS, Images, JSON, Coffeescript, LESS, ... and your custom stuff.
Rich is a Python library for rich text and beautiful formatting in the terminal.
Subscribe to Updates
Get notified when new versions are released