diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4a85ab5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+A linux userspace emulator written in rust.
+It currently is _almost_ able to run a statically linked C hello world executable.
+It has strong memory acces guarantees, faulting on any acces at lest 32 bytes out of any allocation.