LNES-80  /  Open Source

Stop Renting
Your AI's Memory

VMN is the open-source local node for xLMP — the AI Memory Control Plane. Deterministic, content-addressed local memory for AI agents. No cloud required. No embedding-model drift. Your data stays on your NVMe.

GitHub →
v1.5.0
MIT License
11 MCP tools
stdio MCP
Claude Desktop ready
ExergyNet bridge live

Context Collapse Is Killing
Your AI Workflows

Embedding-Model Drift

Your retrieval results change whenever the embedding model updates, chunking strategy shifts, or similarity threshold is retuned. The same query returns different chunks six months later.

🔒
Vendor Lock-In

Your memory lives on someone else’s cloud. Every query is a billable API call. Changing providers means re-embedding your entire knowledge base.

Privacy Risk

Clinical data, trade secrets, and proprietary codebase context uploaded to external embedding servers. One breach exposes everything.

Local-First. Optionally
Globally Connected.

Step 01
01
Ingest

Feed any text to vmn_ingest. xLMP shatters it into 1800-character deterministic memory segments, SHA-256 addressed and stored on your local NVMe. Full BM25 inverted index built in milliseconds.

# MCP tool call vmn_ingest("your text here") # Returns INGESTED. Shard hash: a3f8b2c1d4e5... vault_synced: false
Step 02
02
Recall

Query with vmn_recall. The xLMP pipeline normalizes, stems, and alias-expands every token — so smoking, smoker, and tobacco use all hit the same indexed root. Returns a 900-char evidence window. No drift. Ever.

vmn_recall( hash: "a3f8b2c1...", query: "your query" ) # Returns 900-char evidence window # Same query → same result, always
• Live — v1.5.0
03
Sync

Push any local shard to the ExergyNet LNES-17 thermodynamic ledger with vmn_sync_vault. Or set AUTO_SYNC_VAULT=true to sync every ingest automatically. Cross-device recall and cryptographic provenance, on your terms.

vmn_sync_vault( xlmp_root: "a3f8b2c1..." ) # Returns Canonical Manifest JSON source=exergynet_vault verification=LNES17_HASH

Every token passes through the same 5-stage pipeline at ingest and at query time. Determinism is guaranteed because both sides use identical transformations.

Unicode NFCnormalize accents and composed characters
Phrase aliasesblood pressure → bp  ·  rate limiting → ratelimit
Tokenizesplit on whitespace / punctuation, min length 2
Stem (13 rules)medications → medica  ·  smoking → smok  ·  allergies → allerg
Token alias expandsmok ↔ tobacco ↔ cigarett ↔ nicotine

Up in 60 Seconds

# Install globally $ npm install -g vanguard-memory-node # Or run directly with npx $ npx vanguard-memory-node

Then add to your Claude Desktop config:

// Mac: ~/Library/Application Support/Claude/claude_desktop_config.json // Windows: %APPDATA%\Claude\claude_desktop_config.json { "mcpServers": { "vanguard-memory": { "command": "npx", "args": ["-y", "vanguard-memory-node"] } } }

WSL on Windows: "command": "wsl" with "args": ["-d", "Ubuntu", "npx", "-y", "vanguard-memory-node"]

ExergyNet vault bridge (optional):

# Enable auto-sync on every ingest "env": { "EXERGYNET_API_KEY": "sk-exergy-your-key", "EXERGYNET_NETWORK": "mainnet", "AUTO_SYNC_VAULT": "true" } # EXERGYNET_NETWORK: "mainnet" → portal.exergynet.org # "testnet" → dt.portal.exergynet.org (default)

11 Tools. Every Agent
Workflow Covered.

vmn_ingest

Store text as a SHA-256 content-addressed shard. Segments, indexes, and catalogs locally. Returns root hash + vault_synced flag.

core
vmn_recall

Retrieve a 900-character evidence window from a specific shard. BM25 scoring with stemmed-token fallback. Returns verbatim text — no hallucination.

core
vmn_search

Full-vault keyword search across all ingested objects. Returns ranked results with snippets, scores, and matched terms. Optional namespace filter restricts search to one partition.

core
vmn_list

List all memory objects with optional namespace filter. Returns title, segment count, and timestamps.

catalog
vmn_inspect

Full catalog metadata for a shard: title, namespace, tags, content type, size, excerpt, ingested and updated timestamps.

catalog
vmn_delete

Permanently remove an object and all its index entries from the vault. Only touches the posting buckets that contain the object's terms.

catalog
vmn_stats

Aggregate vault statistics: entry count, total bytes, active namespaces, oldest and newest ingestion timestamps.

diagnostics
vmn_index_status

Current BM25 index state: READY, REBUILD_REQUIRED, REBUILDING, or DEGRADED. Reports version mismatch when normalization or stemmer rules update.

diagnostics
vmn_rebuild_index

Rebuild the full BM25 index from authoritative object files. Safe to run at any time — objects are never modified. Self-healing after any index corruption.

maintenance
vmn_ingest_file

Delta-ingest a growing file using a cursor — only new lines since the last call are stored. Zero duplicates. Designed for Stop hooks and continuous log pipelines. Supports namespace, title, and tags.

automation
vmn_sync_vault

Sync a local object to the ExergyNet LNES-17 ledger via POST /api/xlmp/vanguard/ingest. Reads the raw authoritative file, content-addresses it, and upserts into xlmp_vault. Set EXERGYNET_NETWORK=mainnet or testnet to choose substrate. Requires EXERGYNET_API_KEY.

• bridge — v1.5.0

Deterministic vs Probabilistic Memory

Feature xLMP — VMN Vector DB (Chroma / Pinecone)
Retrieval method Lexical BM25 + stemmed-token fallback Cosine similarity
Result consistency Deterministic — same query, same result Varies — model updates, chunking, or threshold changes alter results
Privacy Local NVMe only (bridge is opt-in) Cloud upload required
Cost Free (local) Per-query API cost
Setup time 60 seconds Hours (embed pipeline)
Cross-device sync Via ExergyNet LNES-17 bridge (live) Yes (cloud-native)
Cryptographic proof Via LNES-04 (planned) Not available

* Vector retrieval results may change when embedding models, chunking strategies, indexes, or similarity thresholds change.

Open Core.
Sovereign Infrastructure.

Community
Free · MIT License

Full VMN core — local ingest, xLMP recall, all 11 MCP tools, 30-case regression gate. No limits. No telemetry. Self-hosted, open source.

Bridge
Live · v1.5.0 · API Key Required

Connect your local vault to the ExergyNet LNES-17 ledger. Cross-device recall and cryptographic provenance via vmn_sync_vault or AUTO_SYNC_VAULT=true. Mainnet and testnet substrate routing via EXERGYNET_NETWORK.

Team
Planned

Shared memory vaults across a workspace. Managed sync, access controls, and usage dashboards via the ExergyNet portal.

Sovereign
Planned · LNES-04

Designed to issue RISC Zero receipts with on-chain Groth16 verification (in development). For clinical, legal, and regulated-context deployments.

VMN is open. The ExergyNet memory network and production control plane are commercial infrastructure.

Sovereign Memory — ExergyNet LNES-04

ZK-Verified, Cross-Team
Memory — In Development

For agents that need verifiable memory — clinical records, financial audits, cross-team evidence sharing — the Sovereign tier is designed to issue a RISC Zero receipt for a committed memory record, with on-chain Groth16 verification. This on-chain path is in development; a real Groth16 proof has been produced end-to-end for a minimal object, and production-scale, per-record settlement is not yet live.

ZK
RISC Zero receipt
On‑Chain
Groth16 settled
v1.5
Current release

LNES-04 on testnet — network pricing displayed before execution

Learn about ExergyNet →
Vanguard Memory Node · v1.5.0 · Open Source

Your memory. Your NVMe.
Your agents.

VMN puts xLMP memory on every developer's machine. ExergyNet connects those memories into the AI Memory Control Plane.

View on GitHub → npm package →