From 690a7b1ceef8db958d56cf92574eed930e6e2f37 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Wed, 17 Jul 2024 10:29:02 -0400 Subject: [PATCH] Improve PyPI install docs (#5118) --- docs/installation.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/installation.md b/docs/installation.md index adda1ac6c..ff20aa748 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -36,7 +36,7 @@ Note when all other installers are used, self updates are disabled. ## PyPI -For convenience, uv is published to [PyPI](https://pypi.org/project/uv/). When installed from PyPI, uv can be built from source but there are prebuilt distributions (wheels) for many platforms. +For convenience, uv is published to [PyPI](https://pypi.org/project/uv/). If installing from PyPI, we recommend using `pipx` to install uv into an isolated environment: @@ -50,6 +50,8 @@ However, `pip` can also be used: pip install uv ``` +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.