docs/install/uv.md
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 --versionto confirm it is installed, then head back to the Installation Guide.
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.
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.
brew install uv
winget install --id=astral-sh.uv -e
scoop install uv
Confirm that uv is installed and on your PATH:
uv --version
You should see output similar to uv 0.x.y (...).
For advanced options (self-update, proxy settings, uninstall, etc.) see the official uv installation docs.