# uvhow: Get uv upgrade instructions for your uv install

I've released [uvhow](https://github.com/python-developer-tooling-handbook/uvhow), a simple command-line tool that detects how [uv](https://pydevtools.com/handbook/reference/uv.md) was installed on your system and provides the correct upgrade instructions.

[uv](https://pydevtools.com/handbook/reference/uv.md) can be [installed through multiple methods](https://docs.astral.sh/uv/getting-started/installation/). When it's time to upgrade, users often struggle to remember which installation method they used, leading to confusion about the correct upgrade command.

uvhow automatically detects your uv installation method and tells you exactly how to upgrade:

```bash
uvx uvhow
```

The tool works across Windows, macOS, and Linux and supports all major installation methods including:

- Standalone installer
- Homebrew
- Package managers (apt, yum, pacman, etc.)
- Cargo
- PyPI installations


Example command:

```
❯ uvx uvhow
🔍 uv installation detected

✅ Found uv: uv 0.6.2 (6d3614eec 2025-02-19)
📍 Location: /Users/timhopper/.cargo/bin/uv

🎯 Installation method: Cargo
💡 To upgrade: cargo install --git https://github.com/astral-sh/uv uv --force
```


Source code and documentation available at [GitHub](https://github.com/python-developer-tooling-handbook/uvhow).

## Learn More

* [How to upgrade uv](https://pydevtools.com/handbook/how-to/how-to-upgrade-uv.md)