From 88a149a8603e4688e5527b6418c96233942e85dd Mon Sep 17 00:00:00 2001
From: Naragod <mateo.naranjo@mail.utoronto.ca>
Date: Wed, 19 Aug 2026 16:43:34 -0400
Subject: [PATCH] TICKET-535: Document uv workflow for developer setup

---
 README.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 88a06ee..dbce755 100644
--- a/README.md
+++ b/README.md
@@ -2,20 +2,22 @@
 
 ## Developers
 
-To install project dependencies, including development dependencies:
+Install the project with its development dependencies:
 
 ```console
-$ pip install -e .[dev]
+$ uv sync
 ```
 
-To install pre-commit hooks:
+(or `pip install -e . --group dev` with pip 25.1+; `dev` is a dependency group, not an extra)
+
+Install the pre-commit hooks:
 
 ```console
 $ pre-commit install
 ```
 
-To run the test suite:
+Run the tests:
 
 ```console
-$ pytest
+$ uv run pytest
 ```