Skip to content
AlphaMergeCase study 03 — AlphaBrainLive · our own product
Case study 03 · Our own product

AlphaBrain — a second brain you still own.

Notes stay as Markdown in a folder in your own Google Drive. AlphaBrain renders the connections between them as a navigable 3D graph — both the links you wrote by hand and the ones it infers from what the notes are actually about.

0
Note text on our servers, Drive mode
.md
The whole file format
3D
Navigable graph
2
Kinds of edge
2

The problem

Note apps ask for years of your thinking and give you an export button. Two problems follow. Your notes end up in a proprietary store you cannot read without the app. And the graph those apps draw only contains the links you remembered to type — which is the smallest and least interesting part of how your notes actually relate.

01The notes must be readable and editable without us
02They must survive you deleting your account
03Relations you never typed should still show up
04Inference must not mean shipping the text off the machine
05A graph is only worth drawing if you can move through it
3

Architecture

Drive is the database. A folder named AlphaBrain holds the notes; the app reads and writes it directly, with no shadow copy and no sync layer to fall out of step. There is no migration to run, because there is nothing to migrate into. A vault on your own disk works the same way, and an opt-in shared brain trades that for one graph several people can edit.

The work that needs a model happens in the browser. A note is read from Drive, embedded client-side, and only two things travel onward: the Drive file id and the resulting vector. The server's whole job is to answer which vectors are close to which — in your own brain it has never seen a sentence you wrote.

Google Drive API Client-side embeddings Vector similarity WebGL 3D graph Markdown Google sign-in
What crosses the wire
Your Drive
/AlphaBrain/*.md
↓read & write, direct
Browser
render · edit · embed
↓file id + vector only
Server
"which relates to which"
✕Note text
✕Titles
✓Drive file id
✓Embedding vector
4

Two kinds of edge

Stylised UI — not a screenshot
AlphaBrain/graph written inferred
rental contracts
e-signature law
audit trails
PDF tooling
drag to orbit · scroll to zoom
rental-contracts.md
Links you wrote
—e-signature-law.md —pdf-tooling.md
Inferred — you did not
┈audit-trails.md0.88 ┈deposit-disputes.md0.81 ┈hebrew-rtl-pdf.md0.74

The dashed edges are the point. They are the notes you would not have thought to look for.

5

The hard problem — inference without surrender

Semantic linking normally means a vendor reads everything you write. That is the trade almost every tool in this category makes quietly. Doing it the other way constrains the whole design: embeddings run in the browser, the server holds vectors it cannot invert into text, and asking for Drive access is something the product has to justify in plain words rather than bury in a consent screen.

Consequence

Embedding cost moves to the client, so the work scales with users rather than with our bill.

Consequence

A breach of our server leaks a list of file ids and float arrays. There is no note to read — unless you opted into a shared brain, which is stored as text by definition.

Cost

Features that need the text — full-text search, summarising a whole vault — are opt-in: a local model where there is one, otherwise a single request you start.

A black screen. Under a cyan ALPHABRAIN wordmark, a paragraph and two short sections headed “Why it asks for Drive” and “Where the text goes”, above a single cyan “Connect with Google Drive” button.
The entry screen states the bargain before asking for anything: why it wants Drive at all, and that the text is embedded in your browser.
6

What shipped

Notes
Markdown in your DriveOr a vault on your own diskOr a shared brain, opt-inRead and write in placeEditable without the appPortable by default
Graph
3D, navigableWritten linksInferred relationsOrbit and zoomMap a GitHub repo, scored on SOLID
Privacy
Client-side embeddingFile id + vector only, Drive and vaultStated in the productNo shadow copy
Next
Mobile captureOpen sign-up — access is by invitation today

Look around it, or have us build one like it.

The entry screen is open to anyone; signing in is by invitation while we use it ourselves. Client-side embeddings and a bring-your-own-storage model transfer to plenty of other products.