Local-first memory and context framework

Memory, illuminated locally.

Lummenna gives agents a structured memory palace, hybrid lexical and vector retrieval, token-budgeted context assembly, and a managed memory lifecycle. The default runtime stays on your hardware; network-backed operations are explicit configuration choices.

Community 1.0.1rc4 / Release artifacts prepared / Stable release pending

Crystalline memory field / local, persistent, illuminated

E2E memory / Recall@10.964

28 queries across 7 synthetic sessions; MiniLM embedder.

BEIR subset / nDCG@100.439

Hybrid macro mean across 5 datasets, each sampled to 500 passages and 20 queries.

Leaderboard statusUnranked

No full-corpus BEIR/MTEB submission or external memory-system comparison is committed.

01 / Why

A memory system with an inspectable shape.

Each statement maps to current implementation. Optional services and commercial controls are named rather than hidden behind broad claims.

01 / Structure

Rooms, loci, chunks

Memories carry location, provenance, validity, value, and retrieval state instead of living in an undifferentiated vector collection.

Community
02 / Retrieval

Signals, then fusion

SQLite FTS5, dense vectors, optional graph traversal, and reciprocal rank fusion form the retrieval path.

Community
03 / Context

Budgeted assembly

Retrieved memories are ranked and assembled into bounded prompt context with explicit truncation behavior.

Community
04 / Lifecycle

Retention has pressure

Time decay, interference, and budget-driven precision changes prevent an unbounded store from masquerading as useful memory.

Community
05 / Interfaces

Use the same palace

Python, MCP, FastAPI, LangChain, and LangGraph adapters connect agents to the same underlying memory model.

Community
06 / Controls

Enterprise boundaries

Encryption at rest, tenant isolation, compliance operations, and advanced P2P controls are license-enforced Pro capabilities.

Pro

02 / Flow

A palace, a searchlight, a gardener.

The operating model stays legible from storage through retrieval and eventual release.

01 / Organize

Place memory

Store a chunk in a named room and optional locus, with provenance and temporal validity recorded beside it.

02 / Retrieve

Fuse evidence

Lexical and semantic candidates are combined, reranked, tenant-scoped, and reinforced when used.

03 / Maintain

Release deliberately

Scheduled decay and budget passes alter value and precision according to explicit, inspectable rules.

Community sidecar

Run the observatory beside your agent.

The direct Community distribution includes a package, corresponding source, and checksum-pinned sidecar recipe without source-control access.

04 / Stable release

Get the stable release notice.

Community 1.0.1rc1 is published through PyPI. Versions 1.0.1rc2 and 1.0.1rc3 remain available as direct releases, and 1.0.1rc4 is prepared for release. Join the waitlist for one notice when the stable package is published.