uv-version
Display uv tool version
TLDR
Display the current project version
Set the project version to a specific value
Bump the project version using semantic versioning
Preview version changes without writing to pyproject.toml
Update version for a specific package in a workspace
Display version in JSON format
SYNOPSIS
uv-version
DESCRIPTION
The uv-version command, most commonly invoked as uv version, provides detailed version information about the uv executable and the current Python environment. uv is a modern, high-performance Python package installer and resolver written in Rust, designed as a faster and more robust alternative to traditional tools like pip.
This command is invaluable for debugging, verifying the correct installation of uv, and understanding the Python environment in which uv is operating. The output typically includes the version of the uv binary itself, the Python interpreter's version and executable path, details about the active virtual environment (if one is in use), and system-specific information such as the operating system and architecture. It helps users and developers quickly ascertain the state of their Python development setup.
CAVEATS
The command uv-version is generally expected to be an alias or symlink to uv version, which is the standard subcommand invocation within the uv ecosystem. uv itself is a rapidly evolving tool; therefore, its output format and specific features may change between versions.
As a new tool, its stability and feature set are subject to ongoing development and refinement.
TYPICAL OUTPUT
The output of uv-version (or uv version) typically includes:
- uv version (e.g., uv 0.1.x)
- Python version and executable path (e.g., Python 3.x.x (path_to_python))
- Virtual environment details (if active, e.g., venv at path_to_venv)
- Operating system and architecture (e.g., linux-x86_64 or windows-x86_64)
NO OPTIONS
The uv-version command, like uv version, does not accept any additional command-line options or arguments. Its sole purpose is to display the version information.
HISTORY
uv was developed by Astral (now Rye) and publicly launched in early 2024 as a groundbreaking, high-performance alternative to existing Python package management tools. Built entirely in Rust, its primary goal is to provide significantly faster dependency resolution and package installation compared to pip and pip-tools. The version command has been a fundamental utility from its inception, enabling users to quickly check their uv installation and environment details.