diff --git a/README.md b/README.md
index 4354082..d13e3e4 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,22 @@ Asimov is our code name for this work untill we get better name and feedback of
 
 ## to run the book
 
+
 ```bash
-hero run -u https://git.ourworld.tf/threefold_coop/info_threefold_coop/src/branch/main/script3 -r 
-```
\ No newline at end of file
+hero mdbook -u https://git.ourworld.tf/threefold_coop/info_threefold_coop/src/branch/main/script3
+```
+
+## First install hero:
+
+```bash
+curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
+bash /tmp/hero_install.sh
+#to debug
+bash -x /tmp/hero_install.sh
+#maybe you want to copy to your system bin dir
+cp ~/hero/bin/hero /usr/local/bin
+#to use hero make sure you restart your shell or you do (if osx)
+source ~/.zprofile 
+#check how to use, can also do on each of the subcommands
+hero -help
+```