diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2d9585f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Not enough devices!
+
+Simple utility to emulate many Birbox devices (or any software basically).
+
+The script launches many instance of the iot-logic but with differenct configurations.
+
+If an instance crashes then it's automatically restarted.
+
+## Usage:
+
+```bash
+python3 main.py [executable path] [number of devices to emulate]
+```
+The executable path is a wrapper script that takes the device id as their only parameter. 
+
+The execution can be stopped with CTRL-C.
+
+The output of every instance is stored individually in the `ned_logs` directory. They are appended, so you need to delete them manually.
\ No newline at end of file