Skip to content

Commit 34d6706

Browse files
committed
docs(README): Add section on uv package manager
1 parent 9111699 commit 34d6706

1 file changed

Lines changed: 65 additions & 2 deletions

File tree

‎README.md‎

Lines changed: 65 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@
2020
## Table of Contents
2121

2222
- [🤔 What is Spec-Driven Development?](#-what-is-spec-driven-development)
23+
- [🛠️ What is `uv`?](#️-what-is-uv)
2324
- [⚡ Get Started](#-get-started)
2425
- [📽️ Video Overview](#️-video-overview)
2526
- [🤖 Supported AI Agents](#-supported-ai-agents)
@@ -40,6 +41,68 @@
4041

4142
Spec-Driven Development **flips the script** on traditional software development. For decades, code has been king — specifications were just scaffolding we built and discarded once the "real work" of coding began. Spec-Driven Development changes this: **specifications become executable**, directly generating working implementations rather than just guiding them.
4243

44+
## 🛠️ What is `uv`?
45+
46+
**[`uv`](https://docs.astral.sh/uv/)** is an extremely fast Python package and project manager, written in Rust. It's a modern replacement for tools like `pip`, `pip-tools`, `pipx`, `poetry`, `pyenv`, and `virtualenv` — all in a single, blazingly fast tool.
47+
48+
### Why Spec Kit Uses `uv`
49+
50+
Spec Kit uses `uv` because it:
51+
52+
- **Installs and manages Python versions** automatically
53+
- **Installs Python packages 10-100x faster** than pip
54+
- **Provides a built-in tool manager** (replacing `pipx`) for CLI tools like `specify`
55+
- **Works consistently** across macOS, Linux, and Windows
56+
- **Requires zero configuration** to get started
57+
58+
### Installing `uv`
59+
60+
Choose the installation method for your operating system:
61+
62+
#### macOS and Linux
63+
64+
```bash
65+
curl -LsSf https://astral.sh/uv/install.sh | sh
66+
```
67+
68+
#### Windows
69+
70+
```powershell
71+
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
72+
```
73+
74+
#### Alternative Installation Methods
75+
76+
**macOS (Homebrew):**
77+
78+
```bash
79+
brew install uv
80+
```
81+
82+
**Linux (snap):**
83+
84+
```bash
85+
sudo snap install astral-uv --classic
86+
```
87+
88+
**With pip:**
89+
90+
```bash
91+
pip install uv
92+
```
93+
94+
For more installation options and troubleshooting, see the [official uv installation guide](https://docs.astral.sh/uv/getting-started/installation/).
95+
96+
### Verifying Installation
97+
98+
After installation, verify that `uv` is available:
99+
100+
```bash
101+
uv --version
102+
```
103+
104+
You should see output like: `uv 0.7.8 (...)` (version number may vary).
105+
43106
## ⚡ Get Started
44107

45108
### 1. Install Specify CLI
@@ -321,8 +384,8 @@ Our research and experimentation focus on:
321384

322385
- **Linux/macOS/Windows**
323386
- [Supported](#-supported-ai-agents) AI coding agent.
324-
- [uv](https://docs.astral.sh/uv/) for package management
325-
- [Python 3.11+](https://www.python.org/downloads/)
387+
- [uv](#️-what-is-uv) - Python package and project manager ([installation guide](#installing-uv))
388+
- [Python 3.11+](https://www.python.org/downloads/) (automatically managed by `uv`)
326389
- [Git](https://git-scm.com/downloads)
327390

328391
If you encounter issues with an agent, please open an issue so we can refine the integration.

0 commit comments

Comments
 (0)