@@ -1,11 +1,69 @@
-<p align="center">
-<img src="https://assets.breatheco.de/apis/img/images.php?blob&random&cat=icon&tags=4geeks,128">
-</p>
+<table>
+<tr>
+<td><img src="https://assets.breatheco.de/apis/img/images.php?blob&random&cat=icon&tags=4geeks,32"></td>
+<td>
+<h1 align="center"> Python exercises at 4Geeks Academy (beta) </h1>
+<img src="https://img.shields.io//last-commit/4geeksacademy/master-python-programming-exercises" />
+<a href="https://breatheco.de"><img src="https://img.shields.io/badge/certified-BreatheCode-blue" /></a>
+<a href="https://twitter.com/alesanchezr"><img src="https://img.shields.io/twitter/follow/alesanchezr?style=social&logo=twitter" alt="follow on Twitter"></a>
+<a href="https://gitpod.io#https://.com/4GeeksAcademy/python-beginner-programming-exercises.git"><img src="https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod" /></a>
+</td>
+</tr>
+</table>
+
+My name is Alejandro Sanchez @alesanchezr. I'm really excited to have you here !! 🎉 😂 Learning to code is hard, you need coaching! DM me on twitter if you have any question.
+
+Complete selection of auto-graded and interactive Python exercises for anyone interested in learning Python!
+
+<ol>
+<li><a href="https://.com/4GeeksAcademy/python-beginner-programming-exercises">Python for Beginners</a></li>
+<li><a href="https://.com/4GeeksAcademy/python-functions-programming-exercises">Practice functions</a></li>
+<li><a href="https://.com/4GeeksAcademy/python-lists-exercises">Practice functions</a></li>
+<li><a href="https://.com/4GeeksAcademy/master-python-programming-exercises">Master Python (← you are here right now)</a></li>
+</ol>
 
-<p>
-<h2 align="center"> Python exercises at 4Geeks Academy (beta) </h2>
+These exercises were built in collaboration, we need you! If you find any bugs or misspells plese contribute and report them.
+
+<p align="center">
+<img src="https://raw.usercontent.com/4GeeksAcademy/react-exercises/master/preview.gif">
 </p>
 
-Complete selection of autograded Python exercises, anyone interested in learning Python!
+<h2>One click installation:</h2>
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io#https://.com/4GeeksAcademy/master-python-programming-exercises.git)
+
+
+## Local Installation
+
+1) Make sure you have the [breathecode-cli](https://.com/breatheco-de/breathecode-cli) installed and `node.js` version 10+ and python version 3+. This is the command to install the breathecode-cli
+```
+$ npm i breathecode-cli -g
+```
+
+2) Clone or download this repository. Once you finish downloading, you will find a new folder with a subdirectory "exercises" that contains all the exercises within.
+
+3) Start the tutorial/exercises by running the following command from the root of the project:
+
+```sh
+$ pip install pytest==4.4.2 mock pytest-testdox
+$ breathecode run
+```
+
+## How are the exercises organized?
+
+Each exercise is a small react application containing the following files:
+
+1. **app.py:** represents the entry python file that will be executed by the computer.
+2. **README.md:** contains exercise instructions.
+3. **test.py:** you don't have to open this file, it contains the testing script for the exercise.
+
+## Contributors
+
+Thanks goes to these wonderful people ([emoji key](https://.com/kentcdodds/all-contributors#emoji-key)):
+
+1. [Alejandro Sanchez (alesanchezr)](https://.com/alesanchezr), contribution: (coder) :computer: (idea) 🤔, (build-tests) :warning:, (pull-request-review) :eyes: (build-tutorial) :white_check_mark: (documentation) :book:
+2. [Paolo (plucodev)](https://.com/plucodev), contribution: (bug reports) :bug:, contribution: (coder), (translation) :earth_americas:
+
+This project follows the
+[all-contributors](https://.com/kentcdodds/all-contributors)
+specification. Contributions of any kind are welcome!