diff --git a/README.md b/README.md
index 98ae1877..efbe35c3 100644
--- a/README.md
+++ b/README.md
@@ -58,6 +58,41 @@ There are three basic categories of incomplete functionality:
 ## Running Grumpy Programs
 
 ### Pre-requisites
+Python 2.7
+pip 
+setuptools
+Go 1.10+ 
+
+### Mac Python 2.7 installation instructions 
+OSX users can go to https://www.python.org/downloads/release/python-2713/ 
+
+Once you've succesfull installed Python2.7 please ensure that pip is also 
+installed on your system by running the command "python -m pip --version". 
+If pip is not installed please follow the instructions found here 
+https://pip.pypa.io/en/stable/installing/#
+
+Once pip has succesfully been installed please run the following command  
+"python -m pip install --upgrade pip setuptools".
+
+### Linux Python 2.7 installation instructions 
+Run the command "python --version" if this command returns Python2.7 
+then it's already installed. If it returns python3+ then run the command 
+"sudo apt install python2.7" Note: Replace "apt" with your package tool.
+
+Next ensure that pip is installed by running "python -m pip --version" 
+or, "python2 -m pip version". If it returns pip [version number] then 
+pip is already installed. If it doesn't run the command "sudo apt install python-pip".
+Note: Again, replace apt with the appropriate package tool.
+
+Once pip has been succesfully installed run the command "python -m pip install --upgrade pip setuptools"
+### GO Lang installation instructions 
+Note: Please download Go 1.10+
+Go lang can be downloaded here: https://golang.org/dl/ 
+
+Please see the official go installation documentation to install Go: https://golang.org/doc/install
+
+If you wish to build Go from source see the documentation here: https://golang.org/doc/install/source
+
 
 The commands ahead assumes that you have Golang installed and a recent
 version of Python 2, `setuptools` and `pip`.