How to upgrade uv
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 updatepipx
If you installed uv via pipx, upgrade using:
pipx upgrade uvpip
If you installed uv with pip, upgrade using:
pip install --upgrade uvFor system-wide installations, you may need:
pip install --upgrade --user uvHomebrew
If you installed uv via Homebrew, upgrade using:
brew upgrade uvTo upgrade all Homebrew packages:
brew upgradeCargo
If you installed uv via Cargo, reinstall to upgrade:
cargo install --git https://github.com/astral-sh/uv uv --forceThe --force flag overwrites the existing installation.
WinGet
If you installed uv via WinGet, upgrade using:
winget upgrade astral-sh.uvTo upgrade all WinGet packages:
winget upgrade --allScoop
If you installed uv via Scoop, upgrade using:
scoop update uvTo update all Scoop packages:
scoop update *Verifying the Upgrade
After upgrading, verify the new version:
uv --versionTip
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.