## Installation instructions for Python, pip, brew, git, virtualenv, and virtualenvwrapper


### [Python 2.7 or 3.*](https://www.python.org/downloads/)

If you're a MAC user, Python should already come preinstalled on your machine. You can use both Python 2.7 or Python 3 with SeleniumBase. If you're on a MAC and have [Homebrew](https://brew.sh/) installed (but not Python 3) you can use: ``brew install python3`` if you wish to use Python 3 instead of Python 2.7. Or you can just get everything from [https://www.python.org/downloads/](https://www.python.org/downloads/).

If you're a WINDOWS user, [download Python 2.7 from here](https://www.python.org/downloads/release/python-2713/) OR [download Python 3.6.2 from here](https://www.python.org/downloads/release/python-362/).


### [Pip](https://en.wikipedia.org/wiki/Pip_%28package_manager%29)

You might already have pip and setuptools installed, but if you don't:

On MAC / Windows / Linux, run the following command:
```bash
python -m ensurepip --default-pip
```

If your existing version of pip is old, upgrade to the latest version:
```bash
python -m pip install --upgrade pip setuptools
```

On CentOS 7 and some versions of Linux, you may need to install pip with ``yum``:
```bash
yum -y update
yum -y install python-pip
```

If you're having any trouble getting pip, you can [GET PIP HERE](https://pip.pypa.io/en/latest/installing/).

When done, make sure the location of pip is on your path, which is `$PATH` for Mac/Linux. (On Windows, it's the System Variables `Path` within System Environment Variables. Ex: Add "C:/Python27/Scripts/" to the end of the `Path` variable.)

### [Homebrew](http://brew.sh/) (MAC-ONLY) (OPTIONAL)

The Homebrew package manager allows you to install things more easily on MacOS, such as Git and Chromedriver.

Here's the command line script to install Homebrew (*from [https://brew.sh/](https://brew.sh/)*):
```bash
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
If you haven't updated Homebrew in awhile, you probably should. Here's how:
```bash
brew update
```

### [Git](http://www.git-scm.com)

(NOTE: You can download the SeleniumBase repository right from GitHub and skip all the git-related commands. That's probably the fastest way if you want to quickly get a live demo of this tool up and running.)

MAC-ONLY: (This step only works if you installed Homebrew in the previous step)
```bash
brew install git
```

(WINDOWS users: Skip the Homebrew part and [download Git here](http://git-scm.com/downloads).)

<a id="virtual_environment"></a>
### [VirtualEnv](http://virtualenv.readthedocs.org/en/latest/) and [VirtualEnvWrapper](http://virtualenvwrapper.readthedocs.org/en/latest/)

(NOTE: Virtual environments allow each your Python projects to have a unique set of packaged dependencies.)

MAC / Linux:
```bash
python -m pip install --upgrade virtualenv
python -m pip install --upgrade virtualenvwrapper
```

WINDOWS:
```bash
python -m pip install --upgrade virtualenv
python -m pip install --upgrade virtualenvwrapper-win
```