uv.md

Installing uv

uv is a fast Python package manager by Astral. Spec Kit uses uv (via uvx or uv tool install) to run the specify CLI without polluting your global Python environment.

Note

Already have uv? Run uv --version to confirm it is installed, then head back to the Installation Guide.

Installation

macOS and Linux — Standalone Installer

The quickest way to install uv on macOS or Linux is the official shell script:

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

After the script finishes, follow any instructions printed by the installer to add uv to your PATH, then open a new terminal.

Windows — Standalone Installer

Run the following in Command Prompt or PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

After the script finishes, open a new terminal so the uv binary is on your PATH.

macOS — Homebrew

brew install uv

Windows — WinGet

winget install --id=astral-sh.uv -e

Windows — Scoop

scoop install uv

Verification

Confirm that uv is installed and on your PATH:

uv --version

You should see output similar to uv 0.x.y (...).

Further Reading

For advanced options (self-update, proxy settings, uninstall, etc.) see the official uv installation docs.