toolbox instalation contents
diff --git a/SUMMARY.md b/SUMMARY.md
index 84616cd..5d36ec0 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -1,3 +1,7 @@
# Summary
-* [First Chapter](chapter1.md)
+* [Main Components](components.md)
+* [Installing Marvin](toolbox_installation/overview.md)
+ * [Ubuntu user installation](toolbox_installation/ubuntu.md)
+ * [MacOS user installation](toolbox_installation/mac.md)
+ * [Vagrant installation](toolbox_installation/vagrant.md)
\ No newline at end of file
diff --git a/components b/components.md
similarity index 100%
rename from components
rename to components.md
diff --git a/toolbox_installation/mac.md b/toolbox_installation/mac.md
new file mode 100644
index 0000000..64acadd
--- /dev/null
+++ b/toolbox_installation/mac.md
@@ -0,0 +1,55 @@
+# Installing Toolbox as MacOS user
+
+1. Libsasl2-dev, Python-pip and Graphviz installation
+```
+sudo easy_install pip
+brew install openssl graphviz
+```
+2. VirtualEnvWrapper Installation
+```
+sudo pip install --upgrade pip
+sudo pip install virtualenvwrapper --ignore-installed six
+```
+3. Spark installation
+```
+curl https://d3kbcqa49mib13.cloudfront.net/spark-2.1.1-bin-hadoop2.6.tgz -o /tmp/spark-2.1.1-bin-hadoop2.6.tgz
+
+sudo tar -xf /tmp/spark-2.1.1-bin-hadoop2.6.tgz -C /opt/
+sudo ln -s /opt/spark-2.1.1-bin-hadoop2.6 /opt/spark
+
+echo "export SPARK_HOME=/opt/spark" >> $HOME/.bash_profile
+```
+If you do not have /opt directory created, before unpacking spark, run:
+```
+sudo mkdir /opt
+```
+4. Set environment variables
+```
+echo "export WORKON_HOME=$HOME/.virtualenvs" >> $HOME/.bash_profile
+echo "export MARVIN_HOME=$HOME/marvin" >> $HOME/.bash_profile
+echo "export MARVIN_DATA_PATH=$HOME/marvin/data" >> $HOME/.bash_profile
+echo "source virtualenvwrapper.sh" >> $HOME/.bash_profile
+
+source ~/.bash_profile
+````
+
+5. Clone and install python-toolbox
+
+```
+mkdir $MARVIN_HOME
+mkdir $MARVIN_DATA_PATH
+cd $MARVIN_HOME
+
+git clone https://github.com/marvin-ai/marvin-python-toolbox.git
+cd marvin-python-toolbox
+
+mkvirtualenv python-toolbox-env
+setvirtualenvproject
+
+make marvin
+````
+
+6. Test the installation
+```
+marvin test
+```
\ No newline at end of file
diff --git a/toolbox_installation/overview.md b/toolbox_installation/overview.md
new file mode 100644
index 0000000..0b4a293
--- /dev/null
+++ b/toolbox_installation/overview.md
@@ -0,0 +1,58 @@
+# General Overview
+
+Toolbox can be installed directly in Ubuntu(Debian) Distribution and MacOS, for other operating systems there is installation through Vagrant or Docker.
+
+## Installing Toolbox as Ubuntu user
+
+1. Libsasl2-dev, Python-pip and Graphviz installation
+```
+sudo apt-get install libsasl2-dev python-pip graphviz -y
+```
+2. VirtualEnvWrapper Installation
+```
+sudo pip install --upgrade pip
+sudo pip install virtualenvwrapper --ignore-installed six
+```
+3. Spark installation
+```
+curl https://d3kbcqa49mib13.cloudfront.net/spark-2.1.1-bin-hadoop2.6.tgz -o /tmp/spark-2.1.1-bin-hadoop2.6.tgz
+
+sudo tar -xf /tmp/spark-2.1.1-bin-hadoop2.6.tgz -C /opt/
+sudo ln -s /opt/spark-2.1.1-bin-hadoop2.6 /opt/spark
+
+echo "export SPARK_HOME=/opt/spark" >> $HOME/.bash_profile
+```
+If you do not have /opt directory created, before unpacking spark, run:
+```
+sudo mkdir /opt
+```
+4. Set environment variables
+```
+echo "export WORKON_HOME=$HOME/.virtualenvs" >> $HOME/.bash_profile
+echo "export MARVIN_HOME=$HOME/marvin" >> $HOME/.bash_profile
+echo "export MARVIN_DATA_PATH=$HOME/marvin/data" >> $HOME/.bash_profile
+echo "source virtualenvwrapper.sh" >> $HOME/.bash_profile
+
+source ~/.bash_profile
+````
+
+5. Clone and install python-toolbox
+
+```
+mkdir $MARVIN_HOME
+mkdir $MARVIN_DATA_PATH
+cd $MARVIN_HOME
+
+git clone https://github.com/marvin-ai/marvin-python-toolbox.git
+cd marvin-python-toolbox
+
+mkvirtualenv python-toolbox-env
+setvirtualenvproject
+
+make marvin
+````
+
+6. Test the installation
+```
+marvin test
+```
\ No newline at end of file
diff --git a/toolbox_installation/ubuntu.md b/toolbox_installation/ubuntu.md
new file mode 100644
index 0000000..3c70bb4
--- /dev/null
+++ b/toolbox_installation/ubuntu.md
@@ -0,0 +1,54 @@
+# Installing Toolbox as Ubuntu user
+
+1. Libsasl2-dev, Python-pip and Graphviz installation
+```
+sudo apt-get install libsasl2-dev python-pip graphviz -y
+```
+2. VirtualEnvWrapper Installation
+```
+sudo pip install --upgrade pip
+sudo pip install virtualenvwrapper --ignore-installed six
+```
+3. Spark installation
+```
+curl https://d3kbcqa49mib13.cloudfront.net/spark-2.1.1-bin-hadoop2.6.tgz -o /tmp/spark-2.1.1-bin-hadoop2.6.tgz
+
+sudo tar -xf /tmp/spark-2.1.1-bin-hadoop2.6.tgz -C /opt/
+sudo ln -s /opt/spark-2.1.1-bin-hadoop2.6 /opt/spark
+
+echo "export SPARK_HOME=/opt/spark" >> $HOME/.bash_profile
+```
+If you do not have /opt directory created, before unpacking spark, run:
+```
+sudo mkdir /opt
+```
+4. Set environment variables
+```
+echo "export WORKON_HOME=$HOME/.virtualenvs" >> $HOME/.bash_profile
+echo "export MARVIN_HOME=$HOME/marvin" >> $HOME/.bash_profile
+echo "export MARVIN_DATA_PATH=$HOME/marvin/data" >> $HOME/.bash_profile
+echo "source virtualenvwrapper.sh" >> $HOME/.bash_profile
+
+source ~/.bash_profile
+````
+
+5. Clone and install python-toolbox
+
+```
+mkdir $MARVIN_HOME
+mkdir $MARVIN_DATA_PATH
+cd $MARVIN_HOME
+
+git clone https://github.com/marvin-ai/marvin-python-toolbox.git
+cd marvin-python-toolbox
+
+mkvirtualenv python-toolbox-env
+setvirtualenvproject
+
+make marvin
+````
+
+6. Test the installation
+```
+marvin test
+```
\ No newline at end of file
diff --git a/toolbox_installation/vagrant.md b/toolbox_installation/vagrant.md
new file mode 100644
index 0000000..f798368
--- /dev/null
+++ b/toolbox_installation/vagrant.md
@@ -0,0 +1,25 @@
+# Installing Toolbox using vagrant
+
+1. Install requirements
+- [Virtual box](http://www.virtualbox.org) (Version 5.1 +)
+- [Vagrant](http://www.vagrantup.com) (Version 1.9.2 or +)
+
+
+2. Clone repository and start provision
+```
+git clone https://github.com/marvin-ai/marvin-vagrant-dev.git
+cd marvin-vagrant-dev
+```
+
+3. Prepare dev (engine creation) box
+```
+vagrant up dev
+vagrant ssh dev
+```
+Wait for provision process and follow interactive configuration script after access the dev box using vagrant ssh command.
+
+4. The marvin source projects will be on your home folder, to compile and use the marvin toolbox
+```
+workon python-toolbox-env
+make marvin
+```
\ No newline at end of file
