Skip to content

Connect

Reach your own machine from somewhere else.

Brainlyy works with no account at all. Connecting one is optional, and it exists for a single reason: so a phone or a web assistant can reach the machine you already set up.

01

Install and set up, on your machine

Nothing here needs an account. At this point you already have notes, search, code graphs and an MCP server.

shell
$uv tool install brainlyy
$brainlyy init

Not on PyPI yet: build the wheel from a checkout, two commands, in the install docs.

02

Create an account on the web app

Google or GitHub. It holds your machine names and nothing else. No card, no trial, no plan to choose.

03

Add a machine, and paste the line it gives you

The web app shows a single-use pairing code and the exact command to run. Your machine dials out and stays connected.

shell
$brainlyy connect A7K2QM94

Worth doing step one first. The account has nothing to show until a machine is running, so signing up early just lands you on an empty list.

What connecting does, and does not, give away.

WHAT YOU GET

  • Search your notes from your phone
  • Let a web assistant read your code graph over MCP
  • See which machines are connected, and when each was last seen

WHAT THE SERVER STILL CANNOT DO

  • Reach into your machine: the connection is dialled out from your side, and no port is opened
  • Write anything by default: only read methods are relayed unless you turn on remote writes yourself
  • See your notes or your models: they stay on your hardware, and the relay only carries what you ask for

Nothing about this is a different product.

The web app is the same Brainlyy you installed, answering through a relay your machine chose to open. It holds no copy of your notes. If you never connect a machine, nothing about the tool changes.

If you would rather not use a hosted anything, do not. Reaching your own dashboard over a mesh VPN needs no account at all, and the security page covers what that costs and what it does not.