diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d93361
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Verilog to LogicWorld compiler
+
+## Setup
+
+Make sure you clone the repo recursively to include the subassembly library:
+
+```bash
+git clone https://gitea.d4vid.xyz/D4VID/verilog2logicworld.git --recursive
+```
+
+## Run
+
+```bash
+cargo run
+```