Installing uv

Install uv with our standalone installers or your package manager of choice (e.g., pip install uv).

Standalone installer

uv provides a standalone installer to download and install uv:

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

$ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

By default, uv is installed to ~/.cargo/bin.

!!! tip

The installation script may be inspected before use:

```console title="macOS and Linux"
$ curl -LsSf https://astral.sh/uv/install.sh | less
```

```console title="Windows"
$ powershell -c "irm https://astral.sh/uv/install.ps1 | more"
```

Alternatively, the installer or binaries can be downloaded directly from [GitHub](#github-releases).

Request a specific version by including it in the URL:

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

$ powershell -c "irm https://astral.sh/uv/0.2.11/install.ps1 | iex"

!!! tip

When uv is installed via the standalone installer, self-updates are enabled:

```console
$ uv self update
```

When another installation method is used, self-updates are disabled. Use the package manager's
upgrade method instead.

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](https://github.com/astral-sh/uv/blob/main/CONTRIBUTING.md#setup)
for details on building uv from source.

Homebrew

uv is available in the core Homebrew packages.

$ brew install 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.

Next steps

See the first steps or jump straight to the guides to start using uv.

2.6 KiB Raw Blame History