Files
github-spec-kit/docs/install/uv.md
Copilot 38bb88bde1 docs: Add uv installation guide and inline callouts (#2465)
* 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>
2026-05-06 15:05:14 -05:00

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 --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.