diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5acae71
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+markov-music
+============
+
+Markov chains are a map of probabilities of one discrete state transitioning to
+another. This is a simple implementation of them to create chord progressions.
+They are pretty straight forward and could be great for practicing quickly
+playing chords on piano/guitar
+
+Use 
+---
+
+To compile and run
+```
+make all
+./bin/markov-music
+```