diff --git a/README.md b/README.md
index 5816a7a..3a7fe89 100644
--- a/README.md
+++ b/README.md
@@ -41,6 +41,14 @@ go run . search -did did:plc:abc123 -rkey 3abc -cluster                # find si
 
 Full API spec (search endpoints, firehose protocol, schemas): **[OpenAPI 3.1](https://divepool.social/api/v1/openapi.json)**
 
+## Experiments
+
+Python scripts in `experiments/` exploring personalized feeds, trend detection, and topic analysis on top of the firehose and search API. Even more heavily vibe-coded than the rest of this repo. Each script's docstring describes usage.
+
+```bash
+pip install -r experiments/requirements.txt
+```
+
 ## Verify embeddings
 
 Verify events from the stream against local EmbeddingGemma output: