Change8

uv

Dev Tools

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

Latest: 0.12.725 releases3 breaking changes5 common errorsView on GitHub

Release History

View all versions →
0.12.71 fix3 features
Aug 27, 2026

This 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 features
Aug 25, 2026

This 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 features
Aug 14, 2026

This 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 features
Aug 13, 2026

This 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 features
Aug 7, 2026

This 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 features
Aug 5, 2026

This 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 features
Jul 31, 2026

This 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 features
Jul 28, 2026

This 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 features
Jul 28, 2026

This 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 features
Jul 23, 2026

This 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 features
Jul 22, 2026

This 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 features
Jul 20, 2026

This 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 features
Jul 15, 2026

This 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 features
Jul 7, 2026

This 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 features
Jul 6, 2026

This 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 fix
Jun 30, 2026

This 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 features
Jun 27, 2026

This 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 feature
Jun 23, 2026

This 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 fixes
Jun 19, 2026

This 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 features
Jun 18, 2026

This 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 features
Jun 11, 2026

This 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 features
Jun 10, 2026

This 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 features
Jun 3, 2026

This 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 feature
Jun 1, 2026

This 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 features
May 28, 2026

This 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 reports

ModuleNotFoundError 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 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