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
- Open PowerShell. You can search for PowerShell in the Start menu. Windows PowerShell 5.1 and PowerShell 7 both work.
- 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.
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.
$env:BRAIN_KEY = "your-key-here"
2. Run the installer
Paste this next, and press Enter.
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.
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.
brain status
# 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.
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.
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
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.
If PowerShell blocks the installer, run it as a script block instead: & ([scriptblock]::Create((irm https://brain.telonyte.com/install.ps1)))
Use the full path shown above, then reinstall with $env:BRAIN_ADD_PATH = "1" and open a new window.
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.