mirrors/uv

mirror of https://github.com/astral-sh/uv.git synced 2025-07-07 13:25:00 +00:00

A ton of work remaining here, pushing so I can preview things rendered.

Here's the [latest rendered
documentation](https://astral-sh.github.io/uv/).

2024-06-26 11:28:42 -05:00

1.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.

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

Note when all other installers are used, self updates are disabled.

PyPI

For convenience, uv is published to PyPI. When installed from PyPI, uv can be built from source but there are prebuilt distributions (wheels) for many platforms.

If installing from PyPI, we recommend using pipx to install uv into an isolated environment:

pipx install uv

However, pip can also be used:

pip install uv

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.

1.4 KiB Raw Blame History