diff --git a/README.md b/README.md
new file mode 100644
index 0000000..918baa3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# flask_bash
+Flask webapp desinged to complement https://github.com/paulwalko/phenny for displaying quotes
+
+Currently implemented at https://paul.walko.org/bash
+
+# Usage:
+Setup flask: http://flask.pocoo.org/docs/0.12/installation/
+
+Run:
+
+```
+python bash.py
+```
+
+Example:
+
+https://paul.walko.org/bash