MIT · open protocol zero-copy · shared memory edge · single ~4 MB engine

The open binary transport for AI agent societies. El transporte binario abierto para sociedades de agentes IA.

The world is trying to run AI societies on slow web architectures from the 2010s. LUMEN runs them on binary, hierarchical, zero-copy memory at the edge — where agents are not scripts connected by APIs, but cognitive threads sharing the same physical memory.

El mundo intenta ejecutar sociedades de agentes IA sobre arquitecturas web lentas de los 2010. LUMEN las ejecuta sobre memoria binaria, jerárquica y zero-copy en el edge — donde los agentes no son scripts conectados por APIs, sino hilos cognitivos que comparten la misma memoria física.

commitscommits
tracked filesficheros
MCP toolstools MCP
repo areasáreas del repo
┌──────────────────────────────────────────────────────┐
│ [Hyb128 LEN:1-5B]  [TYPE:1B]  [FLAGS:1B]  [PAYLOAD] │
└──────────────────────────────────────────────────────┘
  0-63B   → 1 byte        REQUEST   COMPRESSED
  64KB    → 3 bytes       RESPONSE  ENCRYPTED
  4GB     → 5 bytes       NOTIFY    STREAM
  >4GB    → LEB128        STREAM_DATA …

  Overhead: 3 bytes (small payload) to 7 bytes (4 GB)
The protocol in one frame — Hyb128 length encoding, type + flags, then the payload. Repeated keys become 1-byte dictionary IDs.
El protocolo en una trama — codificación de longitud Hyb128, tipo + flags, después el payload. Las claves repetidas pasan a IDs de diccionario de 1 byte.
Why LUMEN existsPor qué existe LUMEN

Three bets. Three walls the industry will hit.Tres apuestas. Tres muros con los que chocará la industria.

01

The I/O collapseEl colapso de I/O

While a human talks to an LLM, JSON latency is invisible. With 10 agents debating, the wire — not the model — is the bottleneck. Binary transport + zero-copy shared memory: up to 58% wire savings, Level 2 SHM (mmap ring buffers), up to 20K calls/sec in stress tests.

Cuando un humano habla con un LLM, la latencia de JSON es invisible. Con 10 agentes debatiendo, el cuello de botella es el cable, no el modelo. Transporte binario + memoria compartida zero-copy: hasta 58% menos cable, SHM nivel 2 (ring buffers mmap), hasta 20K llamadas/s en stress tests.

02

The end of the "RAG memory" patchEl fin del parche "memoria RAG"

Injecting vector DBs into stateless agents is a patch — vectors are an index, not a memory. The real memory is transactional, hierarchical state: PDB (MUMPS-heritage globals, $LOCK, triggers, WAL, 15 µs/GET) plus the M Virtual Machine running persistent M processes.

Inyectar bases vectoriales en agentes sin estado es un parche — los vectores son un índice, no una memoria. La memoria real es estado jerárquico y transaccional: PDB (globals con herencia MUMPS, $LOCK, triggers, WAL, 15 µs/GET) más la M Virtual Machine ejecutando procesos M persistentes.

03

Software Factory, not a frameworkFábrica de software, no un framework

The human should not touch the metal. LUMEN is the open metal of a full cognitive OS: agents that write their own M logic, share the same memory, and execute deterministically at the edge.

El humano no debería tocar el metal. LUMEN es el metal abierto de un sistema operativo cognitivo completo: agentes que escriben su propia lógica M, comparten memoria y ejecutan de forma determinista en el edge.

Numbers, not promisesNúmeros, no promesas

Benchmarked on real MCP payloads.Benchmarkeado sobre payloads MCP reales.

115 tools across 4 servers, 0 errors. Reproducible: python tests/benchmarks/tools_benchmark.py

115 tools en 4 servidores, 0 errores. Reproducible: python tests/benchmarks/tools_benchmark.py

—%

average wire compression across 21 payloads (JSON-RPC → LUMEN)compresión media del cable en 21 payloads (JSON-RPC → LUMEN)

—%

maximum savings (heartbeat / control frames)ahorro máximo (heartbeat / tramas de control)

calls/sec (state_snapshot) in enterprise stress tests — 0 errorsllamadas/s (state_snapshot) en stress tests enterprise — 0 errores

small RPC heartbeat

heartbeat RPC pequeño

tool list (100 tools)

lista de tools (100)

LLM token stream (10K)

stream de tokens LLM (10K)

multi-agent (10×100 reqs)

multi-agente (10×100 peticiones)

One native artifactUn único artefacto nativo

The reference MVM compiles to a single shared library — Rust to machine code, no interpreter, no runtime to install. Runs where a Python stack does not: an edge function, a minimal container, an old laptop.La MVM de referencia compila a una única librería compartida de — Rust a código máquina, sin intérprete ni runtime que instalar. Corre donde un stack Python no: una función edge, un contenedor mínimo, un portátil viejo.

…and in the browser…y en el navegador

The same engine compiles to gzipped WASM (M-Light in the browser). Zero API keys anywhere.El mismo motor compila a de WASM (M-Light en el navegador). Cero claves API en todo el stack.

Open metal, clear boundaryMetal abierto, frontera clara

What is open — and what runs on top.Qué es abierto — y qué corre encima.

MIT · this repoeste repo
LUMEN protocol + transports
Hyb128 · SHM zero-copy · datagram · QUIC · ChaCha20-Poly1305 · macaroons
open
PDB + M-Light + MVM
hierarchical cognitive state · M evaluator · autonomous M processes
open
Poli + Smith
the open agent + multi-personality orchestrator
open
MCP servers (115 tools)
filesystem · web · thinking · PDB — ready for Hermes Agent
open
Tríada A·I·ETríada A·I·E
Astrid · Iris · Elena — three MIT agents, one protocol
open
Proprietary · built on LUMENPropietario · construido sobre LUMEN
ECOS — Edge Cognitive OS
Multi-agent teams, memory consolidation, voice, Lab — the orchestration layerEquipos multi-agente, consolidación de memoria, voz, Lab — la capa de orquestación
🔒
Cadences Lab
The company running its agent ecosystem on LUMENLa empresa que ejecuta su ecosistema de agentes sobre LUMEN
🔒

The metal below is MIT. The layer on top is proprietary. ECOS ↗El metal de abajo es MIT. La capa de arriba es propietaria. ECOS ↗

Everything in the openTodo a la vista

8 areas, one repo.8 áreas, un repo.

Counts generated from git ls-files — never hand-written.Recuentos generados con git ls-files — nunca a mano.

MCP tools

Tool calls, but 44% lighter.Tool calls, pero 44% más ligeras.

tools registered across MCP servers in production, tool definitions across 7 stacks in source. Same integration pattern as any MCP server — drop-in for Hermes Agent. Zero API keys.

tools registradas en servidores MCP en producción, definiciones en 7 stacks del código. Mismo patrón de integración que cualquier servidor MCP — drop-in para Hermes Agent. Cero claves API.

Sample shown. The full catalog lives in the repo (7 stacks: PDB, thinking, filesystem, web, Poli, …).Muestra. El catálogo completo vive en el repo (7 stacks: PDB, thinking, filesystem, web, Poli, …).

Multi-languageMulti-lenguaje

Implementations and bindings.Implementaciones y bindings.

StackStackWhat it isQué esFilesFicheros
60 seconds60 segundos

Quick start.Empezar rápido.

# 📦 Published packages (no clone needed)
pip install lumen-mcp                          # Python
npm install @gonzalomonzonc/mcp-transport      # TypeScript

# Or build from source
git clone https://github.com/GonzaloMonzonC/lumen-protocol.git
cd lumen-protocol

# Rust reference: tests + benches
cd implementations/rust && cargo test && cargo bench && cd ../..

# Register the MCP servers in Hermes Agent (115 tools)
bash scripts/setup_hermes_mcp.sh               # Windows: scripts\setup_hermes_mcp.bat

Docs to go deeper: Para profundizar:

Live proofPrueba en vivo

Chat with the three voices — the full stack in your own Colab.Habla con las tres voces — el stack completo en tu propio Colab.

The demo notebook spins up the real PDB + MVM + cognitive tools and lets you talk with the Council (Astrid · Iris · Elena) with persistent memory. No API keys, no install.El cuaderno levanta el PDB + MVM + herramientas cognitivas reales y te deja hablar con el Council (Astrid · Iris · Elena) con memoria persistente. Sin claves API, sin instalar.

Open in ColabAbrir en Colab
The society on the metalLa sociedad sobre el metal
🧬

Astrid

Audits & anchors evidence — is it true?Audita y ancla evidencia — ¿es verdad? astrid.cadences.app ↗

🌈

Iris

Proposes falsifiable hypotheses — what if…?Propone hipótesis falsables — ¿y si…? iris.cadences.app ↗

🧭

Elena

Signs decision cards — what do we do, now?Firma decision cards — ¿qué hacemos, ahora? elena.cadences.app ↗

◆ LUMEN is the metal. These are its inhabitants — each voice with its own home, three doors to the same protocol.◆ LUMEN es el metal. Estas son sus habitantes — cada voz con su propia casa, tres puertas al mismo protocolo.

For partners & buildersPara partners y builders

Adopted where it matters: in production.Adoptado donde importa: en producción.

Running dailyCorriendo a diario

LUMEN is the transport, memory and execution layer of the Cadences Lab agent ecosystem — independent agents with persistent memory, MVM processes and shared state, in operation every day.LUMEN es la capa de transporte, memoria y ejecución del ecosistema de agentes de Cadences Lab — agentes independientes con memoria persistente, procesos MVM y estado compartido, en operación cada día.

Stress-testedProbado a fondo

Public enterprise stress tests: up to 20K calls/sec, 0 errors, latency and integrity checks — documented in the repo, not in a slide.Stress tests enterprise públicos: hasta 20K llamadas/s, 0 errores, chequeos de latencia e integridad — documentados en el repo, no en una diapositiva.

MIT core, no lock-inNúcleo MIT, sin lock-in

The protocol, transports, storage engine, VM and tools are MIT. Adopt it, fork it, ship it. We build the orchestration layer (ECOS) on top.El protocolo, transportes, motor de almacenamiento, VM y tools son MIT. Adóptalo, forkéalo, publícalo. Nosotros construimos la capa de orquestación (ECOS) encima.