资讯详情

Tool-Python package and project manager-uv

• Home
• GitHub Releases

---

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

Install uv with our official standalone installer:

• Linux/macOS:curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows:powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

~$ uv
An extremely fast Python package manager.Usage: uv [OPTIONS] <COMMAND>Commands:auth       Manage authenticationrun        Run a command or scriptinit       Create a new projectadd        Add dependencies to the projectremove     Remove dependencies from the projectversion    Read or update the project's versionsync       Update the project's environmentlock       Update the project's lockfileexport     Export the project's lockfile to an alternate formattree       Display the project's dependency treeformat     Format Python code in the projectaudit      Audit the project's dependenciestool       Run and install commands provided by Python packagespython     Manage Python versions and installationspip        Manage Python packages with a pip-compatible interfacevenv       Create a virtual environmentbuild      Build Python packages into source distributions and wheelspublish    Upload distributions to an indexworkspace  Inspect uv workspacescache      Manage uv's cacheself       Manage the uv executablehelp       Display documentation for a commandCache options:-n, --no-cache               Avoid reading from or writing to the cache,instead using a temporary directory for theduration of the operation [env: UV_NO_CACHE=]--cache-dir <CACHE_DIR>  Path to the cache directory [env: UV_CACHE_DIR=]Python options:--managed-python       Require use of uv-managed Python versions [env:UV_MANAGED_PYTHON=]--no-managed-python    Disable use of uv-managed Python versions [env:UV_NO_MANAGED_PYTHON=]--no-python-downloads  Disable automatic downloads of Python. [env:"UV_PYTHON_DOWNLOADS=never"]Global options:-q, --quiet...Use quiet output-v, --verbose...Use verbose output--color <COLOR_CHOICE>Control the use of color in output [possible values: auto, always,never]--system-certsWhether to load TLS certificates from the platform's nativecertificate store [env: UV_SYSTEM_CERTS=]--offlineDisable network access [env: UV_OFFLINE=]--allow-insecure-host <ALLOW_INSECURE_HOST>Allow insecure connections to a host [env: UV_INSECURE_HOST=]--no-progressHide all progress outputs [env: UV_NO_PROGRESS=]--directory <DIRECTORY>Change to the given directory prior to running the command [env:UV_WORKING_DIR=]--project <PROJECT>Discover a project in the given directory [env: UV_PROJECT=]--config-file <CONFIG_FILE>The path to a `uv.toml` file to use for configuration [env:UV_CONFIG_FILE=]--no-configAvoid discovering configuration files (`pyproject.toml`, `uv.toml`)[env: UV_NO_CONFIG=]-h, --helpDisplay the concise help for this command-V, --versionDisplay the uv versionUse `uv help` for more details.

Run a tool in an ephemeral environment using uvx (an alias for uv tool run)

Features

Python versions

Installing and managing Python itself.

• uv python install: Install Python versions.
• uv python list: View available Python versions.
• uv python find: Find an installed Python version.
• uv python pin: Pin the current project to use a specific Python version.
• uv python uninstall: Uninstall a Python version.

Installing Python

Scripts

Executing standalone Python scripts, e.g., example.py.

• uv run: Run a script.
• uv add --script: Add a dependency to a script.
• uv remove --script: Remove a dependency from a script.

Running scripts

Projects

Creating and working on Python projects, i.e., with a pyproject.toml.

• uv init: Create a new Python project.
• uv add: Add a dependency to the project.
• uv remove: Remove a dependency from the project.
• uv sync: Sync the project's dependencies with the environment.
• uv lock: Create a lockfile for the project's dependencies.
• uv run: Run a command in the project environment.
• uv tree: View the dependency tree for the project.
• uv build: Build the project into distribution archives.
• uv publish: Publish the project to a package index.

Working on projects

Tools

Running and installing tools published to Python package indexes, e.g., ruff or black.

• uvx / uv tool run: Run a tool in a temporary environment.
• uv tool install: Install a tool user-wide.
• uv tool uninstall: Uninstall a tool.
• uv tool list: List installed tools.
• uv tool update-shell: Update the shell to include tool executables.

Using tools

The pip interface

Manually managing environments and packages — intended to be used in legacy workflows or cases where the high-level commands do not provide enough control.

Creating virtual environments (replacing venv and virtualenv):

• uv venv: Create a new virtual environment.

Using Python environments

Managing packages in an environment (replacing pip and pipdeptree):

• uv pip install: Install packages into the current environment.
• uv pip show: Show details about an installed package.
• uv pip freeze: List installed packages and their versions.
• uv pip check: Check that the current environment has compatible packages.
• uv pip list: List installed packages.
• uv pip uninstall: Uninstall packages.
• uv pip tree: View the dependency tree for the environment.

Managing packages

Locking packages in an environment (replacing pip-tools):

• uv pip compile: Compile requirements into a lockfile.
• uv pip sync: Sync an environment with a lockfile.

Locking environments

Utility

Managing and inspecting uv's state, such as the cache, storage directories, or performing a self-update:

• uv cache clean: Remove cache entries.
• uv cache prune: Remove outdated cache entries.
• uv cache dir: Show the uv cache directory path.
• uv tool dir: Show the uv tool directory path.
• uv python dir: Show the uv installed Python versions path.
• uv self update: Update uv to the latest version.