uvhow: Get uv upgrade instructions for your uv install

uvhow: Get uv upgrade instructions for your uv install

July 22, 2025

I’ve released uvhow, a simple command-line tool that detects how uv was installed on your system and provides the correct upgrade instructions.

uv can be installed through multiple methods. 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:

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.

Learn More

Last updated on

Please submit corrections and feedback...