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.