uv
Dev ToolsAn extremely fast Python package and project manager, written in Rust.
Release History
0.11.28Breaking4 fixes7 featuresThis release focuses heavily on performance optimizations by reducing allocations across various operations and improves error reporting by rendering cause chains and respecting quiet flags. It also includes a security update via the underlying ZIP library.
0.11.277 fixes3 featuresThis release focuses heavily on performance improvements across parsing and scanning operations, alongside several bug fixes related to lock file generation and dependency resolution. A preview feature for discovering extensionless shebang scripts was also introduced.
0.11.261 fixThis release focuses on performance improvements within the PubGrub dependency resolution process and includes one bug fix related to build cache location warnings. Artifacts are now signed with GitHub Artifact Attestations.
0.11.25Breaking2 fixes10 featuresThis release (0.11.25) focuses on security hardening by updating the tar library, alongside numerous enhancements related to lockfiles, dependency scoping, and build backend recommendations. Several preview features for workspace management and environment centralization are also introduced.
0.11.245 fixes1 featureThis release introduces relocatable project environments as a preview feature and includes several bug fixes related to dependency resolution, tool installation cleanup, and shell activation scripts. It also adds compatibility for CPython 3.15.0b3.
0.11.232 fixesThis patch release reverts a recent change that caused unintended breakage in pre-commit-uv and restores previous workspace member handling behavior.
0.11.2214 fixes7 featuresThis release introduces new preview features like SARIF output for auditing and configuration via TOML files, alongside numerous bug fixes related to dependency resolution, validation, and environment handling.
0.11.215 fixes6 featuresThis release adds support for new CPython versions (3.13.14, 3.14.6) and introduces several preview features related to workspace metadata and dependency upgrades. Numerous bug fixes focus on improving cache robustness and hardening parsing across metadata and requirements.
0.11.209 fixes6 featuresThis release introduces new CLI flags for exporting index URLs and listing dependencies, alongside performance improvements and several bug fixes related to symlinks and dependency resolution.
0.11.192 fixes6 featuresThis release introduces support for CPython 3.15.0b2 and adds the PyEmscripten platform. It also includes fixes related to tool uninstallation and cross-installation steps.
0.11.182 fixes1 featureThis release introduces the `uv check` command for running `ty` and includes fixes for a performance regression in wheel unzipping and updates to activation scripts. The MSRV was also bumped to 1.94.
0.11.1712 fixes9 featuresThis release introduces several enhancements, including diagnostics for `uv add` and support for PEP 794 in `uv-build`. Numerous bug fixes address performance, environment handling, and dependency resolution issues.
0.11.165 fixes5 featuresThis release introduces support for direct archive dependencies in Git and allows disabling system configuration via an environment variable. Numerous bug fixes address issues related to environment variable parsing, secret leakage, and entry point validation.
0.11.154 fixes6 featuresThis release (0.11.15) focuses on security enhancements, improved configuration handling for `uv pip compile`, and various performance optimizations across dependency resolution and file operations.
0.11.144 fixes2 featuresThis release introduces an Astral mirror URL override and fixes several bugs related to environment file application, logging output, dependency tree visualization, and lock validation.
0.11.132 fixes1 featureThis release (0.11.13) includes bug fixes related to editable builds and hash requirement enforcement, and adds official support for CPython 3.14.5.
0.11.122 fixes2 featuresThis release introduces support for CPython 3.15.0b1 and adds the --no-editable flag to uv pip install. It also enforces percent-encoding for git refs in URLs.
0.11.111 fixThis release (0.11.11) primarily contains a bug fix allowing acceptance of legacy cache ID formats from older versions. It also provides installation instructions and artifact downloads for the new version.
0.11.101 fixThis release (0.11.10) includes a bug fix allowing pre-release Python requests with non-zero patch versions. It also provides installation instructions for prebuilt binaries.
0.11.910 fixes4 featuresThis release introduces a CPython 3.14.5rc1 candidate to revert memory-intensive garbage collection changes and includes numerous bug fixes across dependency resolution, platform compatibility (Android, Wine, ARMv7), and Windows environment handling. It also deprecates native TLS flags.
0.11.88 fixes10 featuresThis release introduces several enhancements, including new configuration options and improvements to lockfile handling and self-update mechanisms. It also includes numerous bug fixes across dependency resolution, build requirements, and platform-specific behavior.
0.11.77 fixes2 featuresThis release upgrades the underlying CPython build, enhances configuration error reporting for version mismatches, and includes several bug fixes related to dependency installation, TLS handling, and version specifier comparisons.
0.11.63 fixesThis release addresses a low severity security advisory related to malformed wheel RECORD entries during uninstallation. It also includes fixes for cache cleaning errors on Windows and improved wheel validation.
0.11.56 fixes3 featuresThis release introduces support for new CPython versions and adds the `exclude-newer` configuration option for indexes. It also includes several bug fixes related to error handling, path normalization, and Windows uninstallation.
0.11.411 fixes3 featuresThis release (0.11.4) introduces support for `--upgrade-group` and enhances dependency resolution by enforcing stricter hash matching and improving conflict detection. Several bugs related to environment finding, lockfiles, and outdated package listing have also been fixed.
0.11.36 fixes9 featuresThis release (0.11.3) introduces several enhancements including ROCm 7.2 support, PEP 803 implementation, and expanded workspace metadata. It also includes various bug fixes related to hashing, build targets, and dependency checking.
0.11.21 fix4 featuresVersion 0.11.2 enhances the `uv self update` command usability and introduces better error handling for Windows PE editing, alongside a minor fix for `uv run` performance.
0.11.15 fixesThis release (0.11.1) focuses on bug fixes, including improved hash verification for specific Linux targets and better download fallback mechanisms. Documentation updates cover using arbitrary Python environments.
0.11.0Breaking7 fixes3 featuresThis release focuses heavily on upgrading the underlying networking stack, replacing certificate verification libraries, and adopting AWS's cryptography backend, leading to potential changes in TLS behavior. New features include case-insensitive handling of 'Dynamic' values and new options for `uv audit`.
0.10.124 fixes4 featuresThis release introduces support for Python 3.6 interpreters and PyPy 3.11.15, alongside several bug fixes related to dependency management and interpreter detection. Documentation updates clarify Python version support tiers.
0.10.114 fixes3 featuresThis release (0.10.11) focuses on performance improvements, bug fixes related to project file handling and environment synchronization, and updates internal metadata fetching mechanisms.
0.10.109 fixes13 featuresThis release introduces the `--outdated` flag for `uv tool list`, improves error handling and logging, and fixes several bugs related to Windows decompression and environment caching. It also adds support for CPython 3.15.0a7.
0.10.97 fixes7 featuresThis release (0.10.9) focuses on stability, performance improvements like avoiding TOML overhead and using a global workspace cache, and expanding platform/package support, including Python 3.13+ on Android and new PyTorch dependencies.
0.10.87 fixes9 featuresThis release introduces several enhancements including hardened Docker images, default use of Astral mirrors for fetching CPython and releases, and configuration options like UV_INIT_BARE. It also includes numerous bug fixes related to tool upgrades, exclusions, and dependency resolution.
0.10.71 fix1 featureThis release (0.10.7) fixes an issue with junction handling in Windows Containers and introduces activation of logging for middleware retries.
0.10.63 fixesVersion 0.10.6 of uv focuses on bug fixes, including resolving Python version selection conflicts and ensuring file permission preservation during reflinks on Linux.
0.10.57 fixes6 featuresThis release introduces several enhancements related to configuration hints, locking warnings, and file linking strategies, alongside various bug fixes across workspace operations and environment variable handling.
0.10.43 fixes1 featureVersion 0.10.4 of uv focuses on stability, fixing a panic during root initialization and resolving permission issues on built artifacts, alongside improving workspace discovery efficiency.
0.10.35 fixes4 featuresThis release (0.10.3) introduces support for CPython 3.15.0a6 and includes several bug fixes related to version matching and Windows handling. It also enhances logging for preview features.
0.10.21 fixThis release deprecates the use of unexpected ZIP compression methods and fixes a bug where `cargo-install` failed 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 recommendations for shell updates.
0.10.0Breaking1 fix3 featuresThis release stabilizes several preview features, including Python version management and workspace utilities, while introducing several breaking changes related to configuration validation and virtual environment removal behavior.
0.9.302 fixes5 featuresThis release (0.9.30) introduces support for newer Python versions, enhances the `--extra` option, and fixes a deadlock in `uv publish`. It also enables relocatable virtual environments by default as a preview feature.
0.9.295 fixes7 featuresThis release updates the underlying Python environment to Pyodide 0.29.3 and introduces several enhancements to platform naming, publishing, and error handling, alongside various bug fixes.
0.9.281 fix4 featuresThis release updates the bundled CPython to OpenSSL 3.5.5 for security fixes and introduces Pyodide support on Windows. It also includes improvements to index validation warnings and upload skipping logic.
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 fixes an infinite loop related to SSL configuration.
0.9.261 fix6 featuresThis release introduces support for CPython 3.15.0a5 and adds several enhancements to error messaging and build features, including preview support for GCS request signing.
0.9.255 fixes6 featuresThis release introduces support for CPython 3.15.0a4 and upgrades the Tcl/Tk dependency. New features include bytecode compilation flags for installation/upgrade and per-package control over `exclude-newer`.
0.9.242 fixes1 featureThis release includes bug fixes related to sync handling and dynamic distribution rebuilding. It also adds a Rust language classifier to the documentation.
0.9.234 fixes5 featuresThis release introduces support for relative paths in configuration directories, allows setting proxy variables globally, and enables S3 uploads via pre-signed URLs as a preview feature. Several bug fixes address build artifacts, SBOM exports, and platform tag recognition.
0.9.222 fixes1 featureThis release (0.9.22) focuses on improving error messaging and fixing bugs related to wheel filtering and retry counting. Documentation regarding requirements file format has also been clarified.
0.9.211 fixThis release fixes a regression related to zstd distribution hash validation and includes documentation typo fixes.
0.9.206 fixes5 featuresThis is a re-release of version 0.9.19, fixing publishing issues and introducing several enhancements, including CPython 3.15.0a3 support and improved handling of binary flags and interpreter installation.
0.9.187 fixes5 featuresThis release introduces several enhancements to command line usability and publishing, alongside performance improvements and fixes for various bugs related to network requests, file locking, and configuration schema.
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.
Common Errors
ModuleNotFoundError2 reportsModuleNotFoundError usually means a Python package is missing or not accessible in the current environment. To fix it ensure the package is installed in your uv virtual environment using `uv pip install <package_name>` or, if it's a system package like PyGObject, verify it's correctly linked by creating the venv with `--system-site-packages` or explicitly adding its path to `PYTHONPATH`. If this doesn't work, also consider rebuilding the venv.
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