Get started

Overview

Principles, architecture, quickstarts, and mental model for Spectron – memory and knowledge for AI agents on SurrealDB.

Spectron is a memory and knowledge layer for AI agents – a horizontally scalable application tier in front of SurrealDB, which holds every durable record (graph, vector, document, relational, geospatial) with ACID writes, first-class provenance and trust, graph-resident traces, and tri-temporal belief history. Spectron aims for memory that associates related ideas and keeps straight what was said, what is true now, and what used to be true – much like people do, but queryable and auditable in software.

Use this hub to go from principles to running code, then dive into operational sections (knowledge ingestion, conversational memory, self-hosting, integrations, reference).

What Spectron is built to do, what it is not, and how retrieval, traces, and time work:

Quickstarts

How isolation, sessions, categories, and provenance fit together:

  • Knowledge – document ingest, hybrid retrieval, keyword graph.

  • Memory – sessions, operations (remember, recall, reflect, …), reasoning model, tuning.

  • Integrations – SDKs, MCP, framework adapters.

  • Self-hosting – deployment, security, operations, observability.

  • Cookbooks – end-to-end patterns.

  • Reference – REST, management API, CLI, configuration, errors.

Was this page helpful?