uv Installation Guide: How to Install uv on macOS and Windows

30 Dec, 2025

This uv install guide explains how to complete uv installation on macOS and Windows quickly and correctly. Whether you are setting up a new Python environment or replacing tools like pip and virtualenv, this guide walks you through installing uv, verifying it works, and avoiding common issues.

uv is a modern Python package manager written in Rust. It dramatically speeds up dependency resolution, automatically manages virtual environments, and integrates cleanly with existing Python projects.

What Is uv?

uv is an all-in-one Python workflow tool that can replace:

• pip
• pip-tools
• virtualenv / venv
• manual environment activation

Key benefits of uv installation include faster installs, reproducible builds, and simpler workflows — without breaking compatibility with pyproject.toml or existing projects.

System Requirements for uv Installation

Before starting your uv install, make sure you have:

• macOS 11 or newer
• Windows 10 or newer (64-bit)
• Internet access
• No existing Python installation required

uv installs per user and does not require administrator privileges.

uv Install on macOS

Option 1: Install uv with Homebrew (Recommended)

If you already use Homebrew, this is the easiest way to complete your uv installation on macOS.

brew update
brew install uv

Verify the uv install:

uv --version

If a version number is displayed, the uv installation was successful.

Option 2: Install uv Using the Official Script

If you do not use Homebrew, you can install uv directly:

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

Restart your terminal or reload your shell configuration:

source ~/.zshrc
# or
source ~/.bashrc

Verify again:

uv --version

macOS uv Install Troubleshooting

If uv is not found, ensure this directory is in your PATH:

export PATH="$HOME/.local/bin:$PATH"

Add it permanently to your shell configuration file if needed.

uv Install on Windows

Option 1: Install uv Using PowerShell (Recommended)

Open PowerShell (not Command Prompt) and run:

irm https://astral.sh/uv/install.ps1 | iex

Restart PowerShell after installation and verify:

uv --version

Option 2: Install uv with Scoop

If you use Scoop:

scoop install uv

Verify the uv installation:

uv --version

Windows uv Installation Issues

• Restart PowerShell or Windows Terminal after installation
• Confirm %USERPROFILE%\.local\bin is in your PATH
• If script execution is blocked, run PowerShell as Administrator and execute:

Set-ExecutionPolicy RemoteSigned

Verify Your uv Installation

After completing uv installation, test a full workflow:

uv init myproject
cd myproject
uv add requests
uv run python -c "import requests; print(requests.__version__)"

This confirms that uv:

• Created a virtual environment
• Installed dependencies
• Executed Python within the environment automatically

How uv Fits into Modern Python Development

uv simplifies Python workflows by consolidating multiple tools into one:

You can continue using pyproject.toml, existing repositories, and CI pipelines without modification.

Best Practices After uv Installation

• Commit uv.lock to version control
• Use uv add instead of pip install
• Run commands with uv run rather than activating environments
• Standardize uv installation across your team

Conclusion

Completing a uv install on macOS or Windows takes less than a minute, but the benefits are immediate. Faster dependency resolution, automatic environments, and simpler workflows make uv an excellent default choice for modern Python development.

If you are searching for a fast, reliable uv installation guide, this setup will get you productive right away.