diff --git a/README.md b/README.md
new file mode 100644
index 0000000..dfbc3b5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Wavefunction Collapse
+
+This is the example code for my blog post,
+"The Wavefunction Collapse Algorithm explained
+very clearly". To install dependencies:
+
+```
+virtualenv vendor
+source vendor/bin/active
+pip install -r requirements.txt
+```
+
+Then to run:
+
+```
+python main.py
+```
+
+You will get a nice picture of a coastline.
+
+![WFC Example](example.png)
diff --git a/example.png b/example.png
new file mode 100644
index 0000000..813ddf3
Binary files /dev/null and b/example.png differ