diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e3b2608
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Serene (Simple) version
+**Serene simple** is a lisp than is implemented in Java as a proof of concept and as an experience 
+to collect data on some the ideas and implementations that I have. For the full story checkout 
+my [blog](https://lxsameer.com/).
+
+## Requirements
+* JDK >= 1.8
+* rlwrap
+* gradle
+
+## Repl 
+in order to run the REPL, run `make repl`