diff --git a/README.md b/README.md
index 30b401f..b4bb071 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,23 @@
-![](static/ui.gif)
\ No newline at end of file
+# Atlas: Exploration and Mapping with a Sparse Swarm of Networked IoT Robots
+
+![](static/ui.gif)
+
+## Releases
+
+Each major release contains the source code, the log file captured after a long simulation run, and the resulting plots.
+
+## Reproducing a Simulation
+
+- Install [Python 3.x](https://www.python.org/downloads/)
+- Install Python dependencies: `pip install -r requirements.txt`
+- start a simulation: `python RunSim.py`
+- once mapping finished, boundary line turns green
+
+## Contributors
+
+[Razanne Abu-Aisheh](https://www.linkedin.com/in/razanne-abu-aisheh-602b06105/),
+[Thomas Watteyne](http://www.thomaswatteyne.com),
+[Francesco Bronzino](https://www.bell-labs.com/usr/francesco.bronzino),
+[Myriana Rifai](https://www.linkedin.com/in/myriana-rifai-5b6b40b1/),
+[Brian Kilberg](https://www.linkedin.com/in/brian-kilberg/),
+[Kris Pister](https://bamlab.berkeley.edu/).