Mumpix

MumpixDB is the reasoning ledger and structured memory engine for AI systems.

npm install mumpix

What this package is

The mumpix npm package is the Node package for MumpixDB.

It is built for:

• durable AI memory
• ordered reasoning state
• replayable context
• local-first storage
• audit-friendly execution

Core thesis:

Git stores what changed. MumpixDB stores why.

This package is the database layer. It is separate from higher-level products built on top of MumpixDB, including WYD Code.

Why MumpixDB

Most AI systems fail at the memory layer, not the model layer.

MumpixDB gives you:

• local-first storage in a .mumpix file
• append-oriented durable state
• strict and verified execution modes
• replayable memory and audit surfaces
• semantic recall and exact recall
• a structured API for long-running assistants, workflows, and applications

Quickstart

const { Mumpix } = require('mumpix');

async function main() {
  const db = await Mumpix.open('./reasoning.mumpix', { consistency: 'eventual' });

  await db.remember('User prefers short, direct answers');
  await db.remember('Project auth expiry changed from 30min to 15min');

  const answer = await db.recall('what style does the user prefer?');
  console.log(answer);

  const stats = await db.stats();
  console.log(stats);

  await db.close();
}

main().catch(console.error);

Core API

Mumpix.open(filePath, [opts])

Opens or creates a local MumpixDB file.

const db = await Mumpix.open('./agent.mumpix', {
  consistency: 'eventual'
});

Options:

| Option | Type | Default | Description | |---|---|---|---| | consistency | string | 'eventual' | 'eventual', 'strict', or 'verified' | | embedFn | async function | — | Custom embedding function for semantic recall |

Core methods

await db.remember(text);
await db.rememberAll(['one', 'two']);

await db.recall(query);
await db.recallMany(query, 5);

await db.has(query);
await db.list();
await db.clear();
await db.stats();
await db.close();

Temporal API

mumpix also exposes a deterministic temporal layer built on top of WAL-backed records.

This is meant to answer timeline questions by computing over normalized events, not by asking a model to guess from raw text.

const { Mumpix } = require('mumpix');

const db = await Mumpix.open('./agent.mumpix', { consistency: 'eventual' });

await db.remember({
  content: 'I set up the smart thermostat on March 1st.',
  workspace: 'home',
  repo: 'infra-home',
  source: 'ops-log',
  ts: Date.parse('2026-03-03T09:10:00Z'),
});

await db.remember({
  content: 'I set up the mesh network system on March 3rd.',
  workspace: 'home',
  repo: 'infra-home',
  source: 'ops-log',
  ts: Date.parse('2026-03-03T09:00:00Z'),
});

const events = await db.events();
const index = await db.eventIndex();
const result = await db.temporalQuery(
  'Which device did I set up first, the smart thermostat or the mesh network system?'
);

console.log(events.length);
console.log(Array.from(index.byWorkspace.keys()));
console.log(result.value); // smart thermostat

Available temporal package APIs:

• db.events({ query?, topK? })
• db.eventIndex({ query?, topK? })
• db.temporalQuery(query, { topK?, now? })

Low-level exports are also available for advanced use:

const { temporal, temporalEngine, temporalIndexes } = require('mumpix');

These expose:

• deterministic event operators
• event materialization
• event indexing by title, type, workspace, repo, and source

Temporal records support scoped metadata on write:

• workspace
• repo
• source
• ts

Consistency modes

| Mode | Behavior | Use case | |---|---|---| | eventual | fast local writes | prototypes, local tools, development | | strict | stronger durability path | production agents and application state | | verified | durability + audit surfaces | regulated, auditable, or compliance-heavy workloads |

Verified mode methods

const db = await Mumpix.open('./verified.mumpix', { consistency: 'verified' });

await db.audit();
await db.auditSummary();
await db.exportAudit();

Developer SDK

This package also includes a developer client for Mumpix-backed services.

const { MumpixDevClient } = require('mumpix');

const client = new MumpixDevClient({
  baseUrl: 'https://mumpixdb.com/benchmark'
});

const health = await client.health();
const stats = await client.stats();

Available client methods:

• health()
• remember(content)
• recall(query)
• recallMany(query, k)
• memories()
• clear()
• stats()
• settings()
• updateSettings(patch)
• files()
• readFile(file, { atTs, source })
• timeline(file, { source })
• exportUrl(file, format, { atTs, source })
• roms()
• manualForRom(file)
• manualViewUrl(file, { isolate, v })

Integrations

This package includes adapters for:

• LangChain
• LlamaIndex

Examples:

node examples/langchain-adapter.js
node examples/llamaindex-adapter.js
node examples/temporal-memory.js

CLI

npm install -g mumpix

Then:

mumpix --help

Package boundary

The mumpix package is the MumpixDB package.

It is not:

• the WYD Code CLI
• the WYD Code MCP bridge
• the website product shell

Those are separate layers and separate distributions.

Links

• Website: https://mumpixdb.com
• Benchmark: https://mumpixdb.com/benchmark
• Docs: https://mumpixdb.com