diff --git a/README.md b/README.md
index 00ee170b79bb17fe3ca626c9d45152232e71f5cd..861773c6b02a54dad24d9c638e193e8c09d0b7fa 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,18 @@
 # bcm
 
-Behavioral model for corona spread
\ No newline at end of file
+Behavioral model for corona spread
+
+## Installation
+
+Currently you can only clone the sources from ssh://git@gitlab.version.fz-juelich.de:10022/schultz1/bcm.git
+
+## Run
+
+population.py can be run as main program.
+It will generate a population distribution which follows closely the 
+actual data from Germany.
+
+```buildoutcfg
+cd src
+python population.py
+```