Skip to content

Installing uv

Installation methods

Install uv with our standalone installers or your package manager of choice.

Standalone installer

uv provides a standalone installer to download and install uv:

Use curl to download the script and execute it with sh:

$ curl -LsSf https://astral.sh/uv/install.sh | sh

If your system doesn't have curl, you can use wget:

$ wget -qO- https://astral.sh/uv/install.sh | sh

Request a specific version by including it in the URL:

$ curl -LsSf https://astral.sh/uv/0.11.6/install.sh | sh

Use irm to download the script and execute it with iex:

PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Changing the execution policy allows running a script from the internet.

Request a specific version by including it in the URL:

PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/0.11.6/install.ps1 | iex"

Tip

The installation script may be inspected before use:

$ curl -LsSf https://astral.sh/uv/install.sh | less

PS> powershell -c "irm https://astral.sh/uv/install.ps1 | more"

Alternatively, the installer or binaries can be downloaded directly from GitHub.

See the reference documentation on the installer for details on customizing your uv installation.

PyPI

For convenience, uv is published to PyPI.

If installing from PyPI, we recommend installing uv into an isolated environment, e.g., with pipx:

$ pipx install uv

However, pip can also be used:

$ pip install uv

Note

uv ships with prebuilt distributions (wheels) for many platforms; if a wheel is not available for a given platform, uv will be built from source, which requires a Rust toolchain. See the contributing setup guide for details on building uv from source.

Homebrew

uv is available in the core Homebrew packages.

$ brew install uv

MacPorts

uv is available via MacPorts.

$ sudo port install uv

WinGet

uv is available via WinGet.

$ winget install --id=astral-sh.uv  -e

Scoop

uv is available via Scoop.

$ scoop install main/uv

Docker

uv provides a Docker image at ghcr.io/astral-sh/uv.

See our guide on using uv in Docker for more details.

GitHub Releases

uv release artifacts can be downloaded directly from GitHub Releases.

Each release page includes binaries for all supported platforms as well as instructions for using the standalone installer via github.com instead of astral.sh.

Cargo

uv is available via crates.io.

$ cargo install --locked uv

Note

This method builds uv from source, which requires a compatible Rust toolchain.

Upgrading uv

When uv is installed via the standalone installer, it can update itself on-demand:

$ uv self