Installing uv
Installation methods
Install uv with our standalone installers or your package manager of choice.
Standalone installer
uv provides a standalone installer to download and install uv:
Use curl
to download the script and execute it with sh
:
If your system doesn't have curl
, you can use wget
:
Request a specific version by including it in the URL:
Use irm
to download the script and execute it with iex
:
Changing the execution policy allows running a script from the internet.
Request a specific version by including it in the URL:
Tip
The installation script may be inspected before use:
Alternatively, the installer or binaries can be downloaded directly from GitHub.
See the documentation on installer configuration for details on customizing your uv installation.
PyPI
For convenience, uv is published to PyPI.
If installing from PyPI, we recommend installing uv into an isolated environment, e.g., with pipx
:
However, pip
can also be used:
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 for details on building uv from source.
Cargo
uv is available via Cargo, but must be built from Git rather than crates.io due to its dependency on unpublished crates.
Homebrew
uv is available in the core Homebrew packages.
Winget
uv is available via winget.
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
.
Upgrading uv
When uv is installed via the standalone installer, it can update itself on-demand:
Tip
Updating uv will re-run the installer and can modify your shell profiles. To disable this
behavior, set INSTALLER_NO_MODIFY_PATH=1
.
When another installation method is used, self-updates are disabled. Use the package manager's
upgrade method instead. For example, with pip
:
Shell autocompletion
To enable shell autocompletion for uv commands, run one of the following:
# Determine your shell (e.g., with `echo $SHELL`), then run one of:
echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc
echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc
echo 'uv generate-shell-completion fish | source' >> ~/.config/fish/config.fish
echo 'eval (uv generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv
To enable shell autocompletion for uvx, run one of the following:
# Determine your shell (e.g., with `echo $SHELL`), then run one of:
echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc
echo 'eval "$(uvx --generate-shell-completion zsh)"' >> ~/.zshrc
echo 'uvx --generate-shell-completion fish | source' >> ~/.config/fish/config.fish
echo 'eval (uvx --generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv
Then restart the shell or source the shell config file.
Uninstallation
If you need to remove uv from your system, just remove the uv
and uvx
binaries:
Tip
You may want to remove data that uv has stored before removing the binaries:
Note
Prior to 0.5.0, uv was installed into ~/.cargo/bin
. The binaries can be removed from there to
uninstall. Upgrading from an older version will not automatically remove the binaries from
~/.cargo/bin
.
Next steps
See the first steps or jump straight to the guides to start using uv.