How to upgrade uv

Tip

Try my command line tool uvx uvhow for a quick view into your uv install and how to upgrade it. Learn more.

This guide shows you how to upgrade uv to the latest version using your original installation method.

Standalone Installer (Shell Script/PowerShell)

If you installed uv using the standalone installer (curl/powershell), simply run:

uv self update

pipx

If you installed uv via pipx, upgrade using:

pipx upgrade uv

pip

If you installed uv with pip, upgrade using:

pip install --upgrade uv

For system-wide installations, you may need:

pip install --upgrade --user uv

Homebrew

If you installed uv via Homebrew, upgrade using:

brew upgrade uv

To upgrade all Homebrew packages:

brew upgrade

Cargo

If you installed uv via Cargo, reinstall to upgrade:

cargo install --git https://github.com/astral-sh/uv uv --force

The --force flag overwrites the existing installation.

WinGet

If you installed uv via WinGet, upgrade using:

winget upgrade astral-sh.uv

To upgrade all WinGet packages:

winget upgrade --all

Scoop

If you installed uv via Scoop, upgrade using:

scoop update uv

To update all Scoop packages:

scoop update *

Verifying the Upgrade

After upgrading, verify the new version:

uv --version

Tip

For most users, uv self update is the easiest upgrade method. It only works with standalone installer installations, but these are the most common installation method.

Learn More

Also Mentioned In

  1. uv format: Code Formatting Comes to uv (experimentally!)
  2. uvhow: Get uv upgrade instructions for your uv install
  3. uv 0.8 Release: Automatic Python Installation to PATH
  4. How to install uv
Last updated on
How to try the ty type checkerHow to Use `--exclude-newer` for Reproducible Python Environments

Please submit corrections and feedback...