diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ac6864e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# compiler
+### just a simple lisp compiler to learn compiler dev
+
+#### compiling
+to compile run `make`
+
+#### running
+to run the example run `make run`, or to compile another file run `./compiler filename.lisp binaryname`
\ No newline at end of file