Setup

Windows

Install on Windows.

You will use PowerShell. The client is a small Python program. It needs Python 3, and nothing else. After install you get a brain command and a brain-mcp command for editors.

Before you start

  1. Open PowerShell. You can search for PowerShell in the Start menu. Windows PowerShell 5.1 and PowerShell 7 both work.
  2. Type one of these lines and press Enter. If you see a number starting with 3, you are ready. If it is not found, install Python 3 from python.org (tick the box that says Add python.exe to PATH), then open a new PowerShell window and try again.
Paste in PowerShell
py -3 --version
python --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. It is shown once. Never paste it into a chat.

1. Set your key in PowerShell

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

Paste in PowerShell
$env:BRAIN_KEY = "your-key-here"

2. Run the installer

Paste this next, and press Enter.

Paste in PowerShellAvailable now
irm https://brain.telonyte.com/install.ps1 | iex

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 and a brain command shim.

3. Check that the command works

Open a new PowerShell window, then paste this and press Enter. You should see a short success message.

Paste in PowerShell
brain selftest

If PowerShell says brain was not found, run it by its full path, then install once more with PATH turned on so the short name works next time.

Then run brain status. You should see your team name and a line that starts with Hyper speed. When it says Hyper speed: on, a local copy of your team's memory is answering on this computer, kept in sync with the host. If it says off, the line includes the reason.

Paste in PowerShell
brain status
Paste in PowerShell
# run it by its full path
python $env:LOCALAPPDATA\brain-hosted\brain.py selftest

# add the folder to your user PATH, then open a new window
$env:BRAIN_KEY = "your-key-here"
$env:BRAIN_ADD_PATH = "1"
irm https://brain.telonyte.com/install.ps1 | iex

4. Save a fact, then find it

This is the quick test from PowerShell. Paste each line, and press Enter. Replace my-bot with the name of a bot that has already redeemed a key on your team. brain add only works for a bot that is already on the team.

Paste in PowerShell
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.

Optional: a local search model

The client can also install a small local search model. It is optional. The first install downloads about 65 MB, plus a private Python environment, and stays on this computer. After that, brain find can use it when it is available. The built-in engine still answers if the model is off or not installed.

Paste in PowerShell
brain embed status
brain embed install

brain embed status shows whether the model is installed and whether it is answering. If an install is already running in the background, brain embed install waits for it. To turn the model off, set $env:BRAIN_EMBED = "0" in that PowerShell window, or run brain embed off.

If something goes wrong

Python was not found

Install Python 3 from python.org and tick Add python.exe to PATH. Close PowerShell and open a new window, then run py -3 --version.

Scripts are disabled

If PowerShell blocks the installer, run it as a script block instead: & ([scriptblock]::Create((irm https://brain.telonyte.com/install.ps1)))

brain was not found in a new window

Use the full path shown above, then reinstall with $env:BRAIN_ADD_PATH = "1" and open a new window.

You want to uninstall

Set $env:BRAIN_UNINSTALL = "1" and run irm https://brain.telonyte.com/install.ps1 | iex, or use the -Uninstall switch. Your saved key stays unless you also set $env: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.