mirrors/uv

mirror of https://github.com/astral-sh/uv.git synced 2025-11-01 04:17:37 +00:00

A bundle of documentation changes (#5239 )

I just need to iterate on everything and we're not doing a lot of
reviews anyway.

Closes #5234 
Closes #5191

2024-07-22 17:15:11 +00:00

2.4 KiB

Raw Blame History

Installing uv

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

Standalone installer

uv provides a standalone installer that downloads and installs uv:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

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

uv is installed to ~/.cargo/bin.

!!! note

The installation script may be inspected with:

```bash
# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | less

# On Windows.
powershell -c "irm https://astral.sh/uv/install.ps1 | more"
```

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

A specific release can be requested by including the version in the URL:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/0.2.11/install.sh | sh

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

When the standalone installer is used, uv can upgrade itself.

uv self update

When all other installers are 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

There are prebuilt distributions (wheels) for many platforms; if not available for a given platform, uv will be built from source which requires a Rust toolchain to be installed. 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.

2.4 KiB Raw Blame History