diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f923b5d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+Espresso
+
+
+Espresso is a simple operating system built with C and i686(IA32) assembler.
+
+
+== BUILDING ==
+First, you need a cross-compiler and toolchain built, see https://wiki.osdev.org/GCC_Cross-Compiler
+for instructions.
+
+then, `cd` into the directory with the code (you should see the `kernel`, `include`, and `lib` directories if you're in the right place.) and type `make build`. this will also run the OS. type `make clean` after every change to rebuild everything.
\ No newline at end of file