diff --git a/README.md b/README.md
new file mode 100644
index 0000000..59d7e6f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# CPU simulator
+
+I made this for my final year project at Edinburgh University. It is a learning tool which lets you build components of a processor from scratch using NAND gates, and then run actual code on it. 
+
+The code quality was not assessed, and I was working to a very tight deadline, so the code is messy and suboptimal as all hell. I hope to chip away at and make it something that has actual use value rather than just a technical demonstration.