Installing uv

$ curl -LsSf https://astral.sh/uv/install.sh | sh
If your system doesn't have curl, you can use wget:
$ wget -qO- https://astral.sh/uv/install.sh | sh
Request a specific version by including it in the URL:
$ curl -LsSf https://astral.sh/uv/0.8.12/install.sh | sh
Use irm to download the script and execute it with iex:
PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Changing the execution policy allows running a script from the internet.
Request a specific version by including it in the URL:
PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/0.8.12/install.ps1 | iex"
Alternatively, the installer or binaries can be downloaded directly from GitHub.
See the reference documentation on the installer for details on
customizing your uv installation.
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
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.
Homebrew
uv is available in the core Homebrew packages.
$ brew install uv
WinGet
uv is available via WinGet.
$ winget install --id=astral-sh.uv  -e
Scoop
uv is available via Scoop.
$ scoop install main/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.
Cargo
uv is available via Cargo, but must be built from Git rather than crates.io due
to its dependency on unpublished crates.
$ cargo install --git https://github.com/astral-sh/uv uv
This method builds uv from source, which requires a compatible Rust toolchain.
Upgrading uv
When uv is installed via the standalone installer, it can update itself on-demand:
$ uv self update
Updating uv will re-run the installer and can modify your shell profiles. To disable this
behavior, set UV_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:
$ pip install --upgrade uv
Shell autocompletion
You can run echo $SHELL to help you determine your shell.
To enable shell autocompletion for uv commands, run one of the following:
BashZshfishElvishPowerShell / pwsh
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/completions/uv.fish
echo 'eval (uv generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv
if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
Add-Content -Path $PROFILE -Value '(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'
To enable shell autocompletion for uvx, run one of the following:
BashZshfishElvishPowerShell / pwsh
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/completions/uvx.fish
echo 'eval (uvx --generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv
if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
Add-Content -Path $PROFILE -Value '(& uvx --generate-shell-completion powershell) | Out-String | Invoke-Expression'
Then restart the shell or source the shell config file.
Uninstallation
If you need to remove uv from your system, follow these steps:
Clean up stored data (optional):
$ uv cache clean
$ rm -r "$(uv python dir)"
$ rm -r "$(uv tool dir)"
Before removing the binaries, you may want to remove any data that uv has stored.
Remove the uv and uvx binaries:
macOS and LinuxWindows
$ rm ~/.local/bin/uv ~/.local/bin/uvx
PS> rm $HOME\.local\bin\uv.exe
PS> rm $HOME\.local\bin\uvx.exe
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.