# 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.](https://github.com/python-developer-tooling-handbook/uvhow/blob/main/README.md)

This guide shows you how to upgrade [uv](https://pydevtools.com/handbook/reference/uv.md) 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:

```bash
uv self update
```

## pipx

If you installed uv via [pipx](https://pydevtools.com/handbook/reference/pipx.md), upgrade using:

```bash
pipx upgrade uv
```

## pip

If you installed uv with [pip](https://pydevtools.com/handbook/reference/pip.md), upgrade using:

```bash
pip install --upgrade uv
```

For system-wide installations, you may need:

```bash
pip install --upgrade --user uv
```

## Homebrew

If you installed uv via [Homebrew](https://pydevtools.com/handbook/reference/homebrew.md), upgrade using:

```bash
brew upgrade uv
```

To upgrade all Homebrew packages:

```bash
brew upgrade
```

## Cargo

If you installed uv via Cargo, reinstall to upgrade:

```bash
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:

```bash
winget upgrade astral-sh.uv
```

To upgrade all WinGet packages:

```bash
winget upgrade --all
```

## Scoop

If you installed uv via Scoop, upgrade using:

```bash
scoop update uv
```

To update all Scoop packages:

```bash
scoop update *
```

## Verifying the Upgrade

After upgrading, verify the new version:

```bash
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

- [uv: A Complete Guide](https://pydevtools.com/handbook/explanation/uv-complete-guide.md) covers what uv does, how fast it is, the core workflows, and recent releases.
- [How to install Python with uv](https://pydevtools.com/handbook/how-to/how-to-install-python-with-uv.md)
- [uv reference documentation](https://pydevtools.com/handbook/reference/uv.md)