- FactOrder of €50,000 confirmed, delivery in June.cites passage 1
- FactThe account is followed by Luca Bianchi since March.cites passage 2links to Luca Bianchi
Brain at a glance
Introduction
Section titled “Introduction”A graph memory has two sides. On one side is what you add: a source, cut into passages. On the other is what Brain writes from it: pages made of facts. A fact always cites the passages it came from, and that link is what decides who may read it.
Step through the picture, then switch the reader at the last step.
Read as
Rossi Srl signed the order for €50,000, with delivery in June.
Luca Bianchi follows the Rossi account from March.
Luca Bianchi moves to a salary of €45,000.
- FactFollows the Rossi Srl account.cites passage 2links to Rossi Srl
- FactSalary: €45,000.cites passage 3
The words
Section titled “The words”| Word | What it is | Where it lives |
|---|---|---|
| Memory | One place people and agents read from. A graph memory is the kind shown here. | Workspace |
| Schema | What a memory is about and which page types it keeps. | Memory |
| Source | A document, email or note you add. Never edited. | Memory |
| Passage | A piece of a source’s text. Search and Ask read passages. | Source |
| Page | Everything Brain knows about one subject: a company, a person, a project. | Memory |
| Fact | One statement on a page, written by Brain, with its citations. The API calls it a section. | Page |
| Link | A fact on one page that mentions another page. | Fact |
| Conflict | Two statements that disagree, with the passages of both sides. | Page |
| Label | A tag with a written meaning, such as Sales or HR. |
Passage |
| Role | The labels a person may read. | Person |
| Review | Where Brain asks when it is unsure. | Memory |
When a passage is not clear-cut
Section titled “When a passage is not clear-cut”The picture above shows passages that are each about one thing. Two cases go differently: a passage that mixes two subjects, and a passage Brain cannot place. Step through both.
Source · passages
Model call
Who reads what
Section titled “Who reads what”- Passage: you read it when one of your roles grants one of its labels.
- Fact: you read it when you can read every passage it cites.
- Page: it exists for you when you can read at least one of its facts, and it shows only those.
- Link: you see it when you can read a fact that mentions the other page, and that page exists for you.
- Conflict: you read it when you can read the passages of both sides.
- Source: it is listed for you when you can read at least one of its passages. The others are masked in its text.
A page, a fact, a link and a source have no label of their own. Everything Brain writes is read through the passages it came from. The labels a source shows are the labels of its passages, for information only.
How links come and go
Section titled “How links come and go”A link between two pages is never stored on its own. It exists while a fact on one page names the other, so every change to a fact changes the links with it. Step through the cases.
How a worker runs your own models
Section titled “How a worker runs your own models”A memory can use a model that only your machine can reach, such as a local one. The server still runs every job. Only the model call travels: a worker on your machine asks the server for calls, runs them on the local model and sends the answers back. Step through one source, then the two failure cases.
Brain server
QueueJobs waiting, one per source.
JobReads the source, cuts passages, checks labels and roles.
Waiting callsModel calls no one has answered yet.
DatabasePassages, labels, pages and facts.
HTTPS, always opened by the worker
Your machine
WorkerA small program with its own token.
Local modelFor example a model served by Ollama.
- Server: runs the job and is the only one that reads and writes the database.
- Worker: a program you start, with its own token. The token takes calls and answers them. It reads no memory.
- Call: one question to a model with the text it needs: label these passages, find the names, write the pages, embed this text.
- Direction: the worker always calls the server. Your machine needs no open port.
To run one, see Workers.
- A passage that mixes two subjects: Brain cuts it again by sentence and labels the smaller passages.
- Brain is unsure: the passage stays readable by admins only, and one Review item per source asks you.
- You or a rule set a label on the source: its passages take it. Brain may restrict a passage further, and asks when it thinks the label is wrong for a part.
- A new version of a source: passages with the same text keep their labels. Only new text is labelled.
- A new label, or a changed meaning: relabel a source or the whole memory. Nothing is compiled again, because facts follow their passages.
Next steps
Section titled “Next steps”- How a memory works: sources, versions, passages and the tables behind them.
- Schema: page types and guidance per memory.
- Curating: Review, merging pages, editing facts.