diff --git a/web/script/py/readme.md b/web/script/py/readme.md
new file mode 100644
index 000000000..e5ddc0fec
--- /dev/null
+++ b/web/script/py/readme.md
@@ -0,0 +1,13 @@
+Run:
+
+# create a virtual env
+python3 -m venv venv 
+
+# activate the virtual env
+source venv/bin/activate
+
+# install dependencies into it
+pip install -r requirements.txt
+
+# sluggarize your local DB (idempotent; safe to run repeatedly)
+python3 sluggarize_jamtracks.py