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();

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

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