uv
Dev ToolsAn extremely fast Python package and project manager, written in Rust.
Release History
View all versions →0.12.71 fix3 featuresThis release enhances cross-platform dependency resolution by adding support for s390x, ppc64le, and loongarch64 Linux targets. It also introduces a preview feature for content-addressed caching and improves error handling for Azure Storage downloads.
0.12.611 fixes7 featuresThis release updates Python dependencies, enhances cache reporting, and introduces new preview features for workspace management and artifact filtering. It also includes significant performance improvements through profile-guided optimization on various platforms and numerous bug fixes.
0.12.51 fix4 featuresThis release adds support for newer Python versions and introduces several preview features, including named package index selection and enhanced SBOM exports. It also includes improvements to error handling and bug fixes for PEP 723 script path resolution.
0.12.48 fixes6 featuresThis release introduces several enhancements including post-quantum key exchange, improved version parsing, and better error reporting. It also brings performance improvements to resolution and Simple API parsing, alongside various bug fixes.
0.12.34 fixes3 featuresThis release introduces new output formatting options for `uv cache size`, improves memory usage for large workspaces, and enhances performance through various optimizations. It also includes documentation updates and support for CPython 3.13.15.
0.12.23 fixes5 featuresThis release adds support for CPython 3.15.0rc1 and 3.14.7, introduces the `uv tool audit` command, and includes performance improvements for lock file parsing and filename extraction.
0.12.14 fixes4 featuresThis release introduces package-specific pre-release policies, support for local HTML files as flat indexes, and Xonsh virtual environment activation scripts. It also includes performance improvements and various bug fixes.
0.12.0Breaking2 featuresThis release introduces changes that improve correctness, safety, and compatibility with specifications, with many marked as breaking out of an abundance of caution. Key changes include default packaging for `uv init`, stricter archive format validation, and improved pre-release handling.
0.11.333 fixes5 featuresThis release introduces several new features including malware checking for locked tools and the ability to write and read package.metadata-free lockfiles. It also includes bug fixes for dependency splitting and argument parsing.
0.11.321 fix5 featuresThis release introduces new selection options for `uv check`, enhances `uv upgrade` for marker-specific declarations, and improves lockfile handling with `uv lock`. It also includes performance optimizations and a bug fix for universal resolutions.
0.11.314 fixes4 featuresThis release introduces several enhancements including improved workspace source referencing and support for centralized project environments. It also adds new configuration options for malware checking and a preview feature for index-specific hash algorithms.
0.11.302 fixes2 featuresThis release introduces preview features for workspace environment management and includes significant performance improvements in the resolver and cache handling. It also addresses several bug fixes for uninstall operations and pyvenv.cfg preservation.
0.11.2919 fixes11 featuresThis release introduces several enhancements, including JSON output for `uv tree`, support for CUDA 13.2, and improved artifact handling. It also includes numerous bug fixes and performance improvements.
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.
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