|
20 | 20 | ## Table of Contents |
21 | 21 |
|
22 | 22 | - [🤔 What is Spec-Driven Development?](#-what-is-spec-driven-development) |
| 23 | +- [🛠️ What is `uv`?](#️-what-is-uv) |
23 | 24 | - [⚡ Get Started](#-get-started) |
24 | 25 | - [📽️ Video Overview](#️-video-overview) |
25 | 26 | - [🤖 Supported AI Agents](#-supported-ai-agents) |
|
40 | 41 |
|
41 | 42 | 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. |
42 | 43 |
|
| 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 | + |
43 | 106 | ## ⚡ Get Started |
44 | 107 |
|
45 | 108 | ### 1. Install Specify CLI |
@@ -321,8 +384,8 @@ Our research and experimentation focus on: |
321 | 384 |
|
322 | 385 | - **Linux/macOS/Windows** |
323 | 386 | - [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`) |
326 | 389 | - [Git](https://git-scm.com/downloads) |
327 | 390 |
|
328 | 391 | If you encounter issues with an agent, please open an issue so we can refine the integration. |
|
0 commit comments