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
- Open Terminal (from Spotlight, type Terminal, or find it in Applications, then Utilities).
- 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.
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.
export BRAIN_KEY="your-key-here"
2. Run the installer
Paste this next, and press return.
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.
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.
~/.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.
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
Install Python 3 from python.org. Open a new Terminal window and run python3 --version again.
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.
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.
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.