diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..68508a4b8947346014a1ddd22cff036c0ddc6018
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,20 @@
+# Monterey Phoenix - Trace Generator
+
+
+## Setup/Requirements
+* C++ compiler
+
+## Running Event Generator
+The event generator can be run using the rall.sh script in the build folder:
+```bash
+./Code/rall.sh [mp_filepath] [scope]
+```
+- mp_filepath should be the location of the MP file that you want to process
+- scope is the number of repetitions, use higher values with caution
+
+There are example MP files in the Firebird_Pre_loaded_examples folder. To build those files, run the following command:
+```bash
+./Code/rall.sh ./Firebird_Pre_loaded_examples/Example01_simple_message_flow.mp 1
+```
+
+The output will be saved to Example01_simple_message_flow.json
\ No newline at end of file