How to install uv

by Tim Hopper

uv is a fast Python package and project manager. The standalone installer is the recommended way to install it on any platform because it requires no prerequisites: no Python, no package manager, nothing.

Install with the standalone installer

curl -LsSf https://astral.sh/uv/install.sh | sh

On Linux systems without curl, use wget:

wget -qO- https://astral.sh/uv/install.sh | sh

After running the installer, open a new terminal window so the updated PATH takes effect.

Verify the installation

uv --version

If you get command not found, open a new terminal window. The installer modifies your shell profile, but those changes only apply to new sessions. See the platform-specific guides below for detailed troubleshooting.

Alternative methods

The standalone installer works for most setups. If you prefer a platform package manager:

Method	Command
Homebrew (macOS/Linux)	`brew install uv`
WinGet (Windows)	`winget install --id=astral-sh.uv -e`
Scoop (Windows)	`scoop install main/uv`
pip	`pip install uv`
pipx	`pipx install uv`

Tip

Installing uv via pip or pipx creates a circular dependency (you need Python to install the tool that manages Python). The standalone installer avoids this.

Platform-specific guides

These guides cover shell completions, troubleshooting, and platform-specific details:

How to upgrade uv covers updating to the latest version
Create your first Python project walks through using uv after installation
uv reference documents all uv commands
How to add Python to your system PATH with uv helps if Python isn’t found after installing uv

Also Mentioned In

Was this helpful?

Get Python tooling updates

Subscribe to the newsletter

Last updated on March 17, 2026

How to install Python with uv How to install uv on Linux

Please submit corrections and feedback...