How do I upgrade uv to the latest version?

Run `uv self update` if you installed uv via the standalone shell or PowerShell installer. That command only works for standalone-installer installs, which is the most common method. For other installations, use the matching package manager: `brew upgrade uv` for Homebrew, `pipx upgrade uv` for pipx, `pip install --upgrade uv` for pip, `winget upgrade astral-sh.uv` for WinGet, or `scoop update uv` for Scoop.

Why does `uv self update` fail on my system?

`uv self update` only works when uv was installed via the standalone installer (curl on macOS/Linux or PowerShell on Windows). Package-manager installs (Homebrew, pipx, pip, WinGet, Scoop, Cargo) own the binary themselves and must be upgraded with the matching tool, for example `brew upgrade uv` or `pipx upgrade uv`. Run `uvx uvhow` to see the install method and the recommended upgrade command.

How do I check the uv version I have installed?

Run `uv --version`. This prints the installed version, which is useful for verifying that an upgrade actually replaced the binary. After upgrading, the new version should match the latest release on GitHub. If the version doesn't change, the upgrade method may not match the original install path, for example running `brew upgrade uv` on a standalone-installer install.

How to upgrade uv

by Tim Hopper · Markdown

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.

To upgrade uv, run uv self update if you installed it with the standalone installer, the most common method. If you installed uv through a package manager, use that manager’s upgrade command instead:

Install method	Upgrade command
Standalone installer	`uv self update`
Homebrew	`brew upgrade uv`
pipx	`pipx upgrade uv`
pip	`pip install --upgrade uv`
WinGet	`winget upgrade astral-sh.uv`
Scoop	`scoop update uv`
Cargo	`cargo install --git https://github.com/astral-sh/uv uv --force`

The sections below cover each method in detail.

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.

Keep your managed Python interpreters current too

Upgrading uv doesn’t touch the Python versions it manages. To pull the latest patch releases for those, see how to keep Python up to date with uv python upgrade.

Learn More

uv: A Complete Guide covers what uv does, how fast it is, the core workflows, and recent releases.
How to install Python with uv
uv reference documentation

Last updated on July 20, 2026

How to upgrade setup-uv from v7 to v8 How to keep Python up to date with uv python upgrade

Please submit corrections and feedback...