Document how to update backend dependencies with pip-tools

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ambv

README.md

@@ -13,9 +13,8 @@ This project consists of three main components:
 ## Quick Start
 
 ### Prerequisites
-- Python 3.8+
-- Node.js 16+
-- CPython source repository (for benchmarking)
+- Docker Engine 20.10+ and Docker Compose 2.0+
+- CPython source repository (for benchmarking with the worker)
 
 ### Setup & Installation
 ```bash
@@ -58,6 +57,17 @@ make build                  # Build frontend for production
 make clean                  # Clean up generated files and caches
 ```
 
+### Updating Backend Dependencies
+```bash
+# Edit backend/requirements.in, then regenerate the lockfile:
+docker run --rm -v "$(pwd)/backend:/app" -w /app python:3.13-slim-bookworm \
+  sh -c "pip install --quiet pip-tools && pip-compile --strip-extras \
+  --generate-hashes --output-file requirements.txt requirements.in"
+
+# Rebuild the backend container:
+docker compose -f docker-compose.dev.yml up --build -d backend
+```
+
 ## Worker Setup
 
 ### Worker Usage

docker-README.md

@@ -103,6 +103,24 @@ docker-compose up -d backend
 
 ## Development
 
+### Updating Backend Dependencies
+
+Backend dependencies are managed with [pip-tools](https://pip-tools.readthedocs.io/).
+Edit `backend/requirements.in` for direct dependencies, then regenerate the
+pinned lockfile:
+
+```bash
+docker run --rm -v "$(pwd)/backend:/app" -w /app python:3.13-slim-bookworm \
+  sh -c "pip install --quiet pip-tools && pip-compile --strip-extras \
+  --generate-hashes --output-file requirements.txt requirements.in"
+```
+
+Commit both `requirements.in` and `requirements.txt`, then rebuild:
+
+```bash
+docker compose -f docker-compose.dev.yml up --build -d backend
+```
+
 ### Environment Variables
 
 The application uses a `.env` file for configuration. Copy the example and customize: