Setup

Mac

Install on a Mac.

You will use Terminal, which is already on your Mac. The client is a small Python program. It needs Python 3, and nothing else. These steps also work on Linux.

Before you start

  1. Open Terminal (from Spotlight, type Terminal, or find it in Applications, then Utilities).
  2. Type the line below and press return. If you see a number starting with 3, you are ready. If the shell says the command was not found, install Python 3 from python.org, then open a new Terminal window and try again.
Paste in Terminal
python3 --version

You also need a key. Sign in to the dashboard, copy your team's install sentence, and have a bot redeem it, or follow the paste-into-chat path first. Save the key as BRAIN_KEY. It is shown once. Never paste it into a chat.

1. Set your key in Terminal

Paste this, replace the placeholder with your real key, and press return. This only lasts for the current Terminal window.

Paste in Terminal
export BRAIN_KEY="your-key-here"

2. Run the installer

Paste this next, and press return.

Paste in TerminalAvailable now
curl -fsSL https://brain.telonyte.com/install.sh | bash

The installer saves your address and key to a private config file, so later commands work without typing the key again. It also installs brain-mcp, which editors use.

3. Check that the command works

Paste this, and press return. You should see a short success message.

Paste in Terminal
brain selftest

If the shell says brain was not found, the program is in ~/.local/bin. Run it by its full path, then add that folder to your PATH so the short name works next time.

Paste in Terminal
~/.local/bin/brain selftest

# if you use zsh (the default on a Mac)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# if you use bash (use ~/.bash_profile on a Mac)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

You can also run the installer with BRAIN_ADD_PATH=1 in front of the curl command, and it adds that PATH line for you. To install somewhere else, set BRAIN_INSTALL_DIR.

4. Save a fact, then find it

This is the quick test from Terminal. Paste each line, and press return.

Paste in Terminal
brain add my-bot "NEW | The staging deploy runs on Fridays | team notes"
brain find staging deploy

The second command should print the note about Fridays. If you use an AI editor next, also do the new-chat test on that editor's guide.

If something goes wrong

python3 was not found

Install Python 3 from python.org. Open a new Terminal window and run python3 --version again.

brain was not found

Use the full path ~/.local/bin/brain, then add ~/.local/bin to your PATH with the commands above. Open a new Terminal window after you change your profile.

The key was not accepted

Check that you exported BRAIN_KEY in the same Terminal window before you ran the installer. If the key was revoked, get a new one from the dashboard and do not paste it into a chat.

You want to uninstall

Run curl -fsSL https://brain.telonyte.com/install.sh | bash -s -- --uninstall. Your saved key stays unless you also set BRAIN_REMOVE_CONFIG=1.

Other ways to install

All paths · AI bots, including Grok Bot · Mac · Windows · Claude Code · Cursor · Claude Desktop · Gemini CLI · Direct API · Developers

Keep your key private

Never paste an API key into a chat, a ticket, or a note. Each bot has its own key, and you can pause or revoke it in the dashboard. Questions? Contact us.