inite-ai/inite-brain-service

Open-source memory for AI agents: a bitemporal knowledge graph with provenance, over MCP and REST.
Website ·
Quick start ·
Architecture ·
Domain Packs ·
Getting started ·
Docs ·
Agent guide
## Quick start
Needs Docker with Compose v2, openssl, and an OpenAI API key (the default
model configuration). Runs the released image (linux/amd64 and
linux/arm64) with SurrealDB; no clone, no build.
bash
: "${OPENAIAPIKEY:?export OPENAIAPIKEY first}"
mkdir inite-brain && cd inite-brain
curl -fsSLO https://raw.githubusercontent.com/inite-ai/inite-brain-service/main/docker-compose.quickstart.yml
BRAINKEY="brain$(openssl rand -hex 24)"
KEYHASH="$(printf %s "$BRAINKEY" | openssl dgst -sha256 -r | cut -d' ' -f1)"
cat > .env conversations · documents · facts"]
raw[("Source records documents · episodes · evidence")]
derive["Indexers and scene builders candidates · entity resolution · conflicts"]
memory[("Connected memory on SurrealDB facts + graph · scenes · beliefs")]
retrieve["Retrieval semantic + lexical · graph · multi-hop"]
answer["Synthesis + verification answer with citations or abstention"]
packs["Domain Packs vocabulary · memoryModel · tools"]
media["Evidence registration / upload scan hook · trusted processors"]
input --> raw
input --> derive
media --> raw
raw --> derive
derive --> memory
memory --> retrieve
raw --> retrieve
retrieve --> answer
packs -. "domain configuration" .-> derive
packs -. "capabilities and consent" .-> media
| Memory layer | What it preserves |
| Facts and entities | Typed claims, canonical entities, relationships, confidence, source attribution and temporal history. |
| Episodes | Source turns and conversation context that derived memory can point back to or be rebuilt from. |
| Scenes | Bounded events with gists, entities, state changes and source links. Optional gist embeddings and a scene retrieval lane make them searchable alongside other evidence. |
| Beliefs | Derived state with revision history and supporting scenes. Pack-projected state deltas can feed belief promotion. |
| Evidence | Assets, located fragments, processing runs and derived representations, with links to the memories they support. |
Rebuildable memory. Derived worlds can be rebuilt from retained episodes in
a staging version. Readers stay pinned to the previous world until promotion.
Scene maintenance can process dirty conversations on a schedule, with budgets,
leases and metrics; it can compose scenes and promote supported beliefs.
Configurable retrieval. Retrieval profiles select mechanisms for the corpus
and question. Semantic and lexical search, graph expansion, reranking, raw
passages, scene retrieval and belief retrieval are distinct capabilities. A
known entity can enter through graphretrieve; a question spanning
relationships can use searchmultihop.
Separate serving and background work. The NestJS service uses a
SurrealDB-backed job queue, leases and worker-thread offloads. Run the image as
one process or split PROCESSROLE=api|worker; see the
operations guide.
The code includes capabilities that are opt-in, not a promise that every
installation runs every layer. Scene construction, scene serving, belief
promotion, evidence upload/processing and pack projections have separate gates.