diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0328e0d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# markov-bot
+
+Markov chain discord bot, sends randomly generated sentences once an hour and when mentioned.
+
+## Setup
+
+Put some text into `corpus.txt`, and then run
+
+    git clone https://git.xeno.science/xenofem/markov-bot
+    cd markov-bot
+    python3 -m venv env
+    source env/bin/activate
+    pip install discord.py
+    python markov-prep.py
+    echo <token> > token
+    python markov-bot.py