diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..eb4e814
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,26 @@
+chadbook
+========
+
+minimal jupyter notebook boilerplate using uv.
+
+
+install uv
+----------
+
+linux/mac:
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+
+windows:
+    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+
+run the notebook
+----------------
+
+    just run
+
+or:
+
+    uv run jupyter lab
+
+opens in your browser. click notebook.ipynb.