# Install Godspeed Mission Control on a Mac

Canonical: https://godspeedmissioncontrol.com/guide/install-mac

The Mac route is experimental. Its installer supports Intel and Apple silicon, but we have not checked the whole setup on a physical Mac. For this beta, we recommend [Windows](/guide/install-windows) or [Linux](/guide/install-linux).

You need Homebrew, the free tool from [brew.sh](https://brew.sh) that installs programs. The installer uses it to add anything else it needs, and if your Mac has no Homebrew yet, it says so before it changes anything. The install takes a few minutes.

## Install

1. Open **Terminal**: press Cmd+Space, type `Terminal` and press Return.
2. Paste this line and press Return:

   ```bash
   curl -fsSL https://godspeedmissioncontrol.com/install | bash
   ```

3. Wait for the end. Near the end it says that Godspeed runs in the background, and where your mission control is:

   ```text
   The notebook runs in the background on this Mac, and it starts by itself whenever you log in.

   Your mission control is in /Users/you/godspeed-v2.
   ```

## Open your notebook

Your notebook is the page in your web browser where you talk to Godspeed and see what it knows and does.

1. Open [http://127.0.0.1:47831/dashboard](http://127.0.0.1:47831/dashboard) in your browser.
2. You see **Your notebook**, with a big **Chat with Godspeed** button.

   ![Your notebook: the sidebar on the left, Your notebook at the top, and the blue Chat with Godspeed button on the right](/guide-images/dashboard.png)

Godspeed starts by itself whenever you log in to this Mac and keeps running when you close Terminal. Only this Mac can open the notebook. Bookmark the address.

## Next

[First setup: connect your AI](/guide/first-setup#on-a-mac-or-linux-computer), so Godspeed can answer you and your routines can run.

## Check the download first

To read the installer before it runs, use these two lines instead of step 2. The first saves it as `install-godspeed.sh` in the folder Terminal is in:

```bash
curl -fsSLO https://raw.githubusercontent.com/MichaelZelbel/godspeed-mission-control/beta/install-godspeed.sh
```

Open the file in a text editor and read it. The second line runs it:

```bash
bash install-godspeed.sh
```

It is the same file the line in step 2 runs, and it installs the same release.

## If it stops and says to add --beside

This Mac already has an earlier Godspeed. Download the installer with the first line above, then run `bash install-godspeed.sh --beside --godspeed "$HOME/godspeed-v2"`. The new one gets its own folder, and the earlier one stays as it is.

## If it says something about Hermes

Hermes is the program that runs your assistant.

- **"The Hermes found at … so Godspeed keeps using the one at …"** The installer found another Hermes on this computer that does not work for your account. Godspeed keeps the one it used until now, so there is nothing to do.
- **"Hermes, the AI program Godspeed uses, does not load for this account"** Your assistant and add-ons cannot reach your AI until it does. Everything else was installed. [Problems after installing](/guide/troubleshooting#godspeed-could-not-load-its-ai-program-hermes-on-this-computer) says what to do.