mirror of
https://github.com/astral-sh/uv.git
synced 2025-10-20 23:31:54 +00:00
dd1934c9c3
[Rendered](https://github.com/astral-sh/uv/blob/zb/030/CHANGELOG.md#030) --------- Co-authored-by: Charlie Marsh <charlie.r.marsh@gmail.com>
104 lines
2.6 KiB
Markdown
104 lines
2.6 KiB
Markdown
# 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:
|
|
|
|
```console title="macOS and Linux"
|
|
$ curl -LsSf https://astral.sh/uv/install.sh | sh
|
|
```
|
|
|
|
```console title="Windows"
|
|
$ 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:
|
|
|
|
```console title="macOS and Linux"
|
|
$ curl -LsSf https://astral.sh/uv/0.3.0/install.sh | sh
|
|
```
|
|
|
|
```console title="Windows"
|
|
$ powershell -c "irm https://astral.sh/uv/0.3.0/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](https://pypi.org/project/uv/).
|
|
|
|
If installing from PyPI, we recommend installing uv into an isolated environment, e.g., with `pipx`:
|
|
|
|
```console
|
|
$ pipx install uv
|
|
```
|
|
|
|
However, `pip` can also be used:
|
|
|
|
```console
|
|
$ 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.
|
|
|
|
```console
|
|
$ brew install uv
|
|
```
|
|
|
|
## Docker
|
|
|
|
uv provides a Docker image at
|
|
[`ghcr.io/astral-sh/uv`](https://github.com/astral-sh/uv/pkgs/container/uv).
|
|
|
|
See our guide on [using uv in Docker](../guides/integration/docker.md) for more details.
|
|
|
|
## GitHub Releases
|
|
|
|
uv release artifacts can be downloaded directly from
|
|
[GitHub Releases](https://github.com/astral-sh/uv/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](./first-steps.md) or jump straight to the [guides](../guides/index.md) to
|
|
start using uv.
|