* Initial plan * docs: Add uv installation guide and inline callouts Agent-Logs-Url: https://github.com/github/spec-kit/sessions/027c81a0-57f2-4f67-ab54-4c72f93eb254 Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com> * docs: improve uv install guide PATH and Windows instructions Agent-Logs-Url: https://github.com/github/spec-kit/sessions/f56bcfb8-2cf5-44a5-b5e5-0fd6c3caa46f Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com> * docs: clarify uv note in README applies only to uv commands not pipx Agent-Logs-Url: https://github.com/github/spec-kit/sessions/a6ada1f7-522d-4a31-ac5b-880e763f9c97 Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com> * docs: clarify uv note in installation.md applies only to uvx commands not pipx Agent-Logs-Url: https://github.com/github/spec-kit/sessions/4ec791dd-b048-4606-8db3-671bc8956b05 Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>
1.5 KiB
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 --versionto 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.