> For the complete documentation index, see [llms.txt](https://nateskicks13.gitbook.io/bird-bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nateskicks13.gitbook.io/bird-bot/installation/mac.md).

# Mac

How to download Bird Bot on Mac OS

## 1. Download Git

To download Git, use the installer from [here](https://sourceforge.net/projects/git-osx-installer/). It should download as a dmg file.

{% hint style="info" %}
You can also watch a tutorial video [here](https://www.youtube.com/watch?v=sJ4zr0a4GAs)
{% endhint %}

![](https://613260287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4tYcD4ZJuCWOF68IVn%2F-M4t_UkStP4wxH1YzA2R%2F-M4taAixuM-LyGQGFcHZ%2FScreen%20Shot%202020-04-14%20at%2012.49.23%20PM.png?alt=media\&token=519eea6a-ebf4-43b7-9ef3-fca2496eb48c)

Open the dmg and you will see a .pkg file. Double click it. 

![](https://613260287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4tYcD4ZJuCWOF68IVn%2F-M4t_UkStP4wxH1YzA2R%2F-M4tbDmC43qFLSkDozlH%2FScreen%20Shot%202020-04-14%20at%2012.51.00%20PM.png?alt=media\&token=1a29b20a-3a82-4b57-8c9f-ca7963ab0069)

{% hint style="danger" %}
If you get a "cannot be opened because it is from an unidentified developer" message when trying to run the .pkg file, go to system preferences -> security and privacy -> and then click "open anyway" at the bottom. If you get stuck, watch a tutorial video [here](https://www.youtube.com/watch?v=yJoSrBe7Tpg).
{% endhint %}

You will then see an installer pop up. Navigate through the steps until it has finished downloading.

![](https://613260287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4tYcD4ZJuCWOF68IVn%2F-M4tbFSEI8KlUnoSHOAD%2F-M4tbT54Y2g7j2VLAm6x%2FScreen%20Shot%202020-04-14%20at%2012.54.49%20PM.png?alt=media\&token=be19f494-5ba2-42e2-98df-646cc8e237bc)

## 2. Download Python 

To download Python, use the installer from [here](https://www.python.org/ftp/python/3.8.2/python-3.8.2-macosx10.9.pkg). It should download as a .pkg file. Double click it and you will then see an installer pop up. Navigate through the steps until it has finished downloading.

{% hint style="info" %}
You can also watch a tutorial video [here](https://www.youtube.com/watch?v=TgA4ObrowRg)
{% endhint %}

![](https://613260287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4tYcD4ZJuCWOF68IVn%2F-M4tbFSEI8KlUnoSHOAD%2F-M4tcOGNJVPcSN7FJ8IY%2FScreen%20Shot%202020-04-14%20at%2012.58.50%20PM.png?alt=media\&token=8f81dc6c-716c-4676-9236-7ae058ebaa07)

## 3. Download the bot

To start, open a new terminal window. If you don't know how to open terminal, you can find it by going to search on your mac and typing in "terminal"

![](https://613260287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4tYcD4ZJuCWOF68IVn%2F-M4tbFSEI8KlUnoSHOAD%2F-M4tdK_bEQ9d3TAhMYgp%2FScreen%20Shot%202020-04-14%20at%201.02.32%20PM.png?alt=media\&token=deb258c4-1143-466e-82ee-f03001fb6274)

Then, type in the following

```bash
cd desktop
```

```bash
git clone https://github.com/natewong1313/bird-bot
```

```bash
cd bird-bot
```

![](https://613260287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4tYcD4ZJuCWOF68IVn%2F-M4ttBZnrio-rOvMABbE%2F-M4ttoLytzBHyy10Ozi0%2FScreen%20Shot%202020-04-14%20at%201.06.02%20PM.jpg?alt=media\&token=6627ce0e-32e4-4887-b4a8-7e4ecfffec9d)

After that, you will need to install the Python modules that help power the bot. To do this, type in the following

```bash
sudo pip3 install -r requirements.txt
```

It may prompt you to enter in your password. Type it and hit enter.

## 4. Run the bot

To run the bot, simply type 

```bash
python3 app.py
```

After that, the bot should open up. 

If you want to run the bot again, simply run that same command again in the same terminal window. **If you exit out of the terminal window and want to run the bot again, open up a new terminal window and run these commands**

```bash
cd desktop/bird-bot
```

```bash
python3 app.py
```