diff --git a/README.md b/README.md
new file mode 100644
index 0000000..77f95b8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# 3DChess ♟
+
+Super chess engine. Outputs to console, Java Swing and 3D (Lwjgl) !
+
+## Features 🌟
+
+- Views:
+    - Console
+    - Java Swing
+    - OpengGL (3D)
+
+- Audio
+- Pgn support (import/export)
+- Undo moves support
+- AIs:
+    - DumbAI: just makes some random moves
+    - HungryAI: tries to eat the biggest piece (no depth, no thinking)
+    - AlphaBetaAI: plays the best move by searching through all possible moves
+
+## Run 🏃
+
+```
+./gradlew run
+```
+
+## Run tests 🗣️🔥
+
+```
+./gradlew test
+```
\ No newline at end of file