Neural Memory

Memoria persistente para agentes de IA — 55 herramientas MCP, recuperación por activación propagada, consolidación inspirada en neurociencia

Documentación

NeuralMemory

GitHub stars PyPI Downloads CI Python 3.11+ License: MIT VS Code OpenClaw Plugin

Tu agente de IA olvida todo entre sesiones. Neural Memory le da un cerebro.

Sitio web · Inicio rápido · Herramientas MCP · Pro · Registro de cambios

Neural Memory — spreading activation

Los recuerdos se almacenan como neuronas interconectadas y se recuperan mediante activación propagada, de la misma manera que funciona el cerebro humano. Sin base de datos vectorial. Sin llamadas a API. Sin factura mensual de embeddings.

pip install neural-memory

Reinicia tu herramienta de IA. Tu agente ahora recuerda, sin necesidad de init: el servidor MCP se autoinicializa en el primer uso.

¿Ya está instalado? nmem update actualiza en el lugar y detecta si instalaste vía pip o desde el código fuente. nmem update --check solo informa lo que está disponible.

El CLI es nmem (o la versión más larga neural-memory). No existe un binario nm.


3 Herramientas. Eso es todo.

Hay 63 herramientas MCP disponibles, pero solo necesitas tres:

HerramientaQué hace
nmem_rememberAlmacena un recuerdo: detecta automáticamente tipo, etiquetas y conexiones
nmem_recallRecupera mediante activación propagada: los recuerdos relacionados surgen de forma natural
nmem_healthPuntaje de salud cerebral (A–F) con sugerencias de corrección accionables

Todo lo demás (sesiones, carga de contexto, seguimiento de hábitos, mantenimiento) funciona de forma transparente en segundo plano.

Las 63 herramientas MCP →


Qué hace esto diferente

La mayoría de las herramientas de memoria son motores de búsqueda. Neural Memory es un grafo que piensa.

Cuando preguntas "¿Por qué ocurrió la interrupción del martes?", una base de datos vectorial devuelve la oración más similar. Neural Memory rastrea la cadena:

outage ← CAUSED_BY ← JWT expiry ← SUGGESTED_BY ← Alice's review

Las relaciones son explícitas — CAUSED_BY, LEADS_TO, RESOLVED_BY, CONTRADICTS — para que tu agente no solo encuentre recuerdos, sino que razone a través de ellos.

Basado en búsqueda (RAG)Neural Memory
RecuperaciónPuntaje de similitudRecorrido de grafo
RelacionesNinguna24 tipos explícitos
LLM requeridoSí (embedding)No: totalmente offline
Razonamiento multi-saltoMúltiples consultasUn solo recorrido
Ciclo de vida de la memoriaEstáticoDecaimiento, refuerzo, consolidación
Costo por 1K consultas~$0.02$0.00

Sincronización en la nube: tus datos, tu infraestructura

Sincroniza tu cerebro en todas tus máquinas. A diferencia de otras herramientas de memoria, nunca almacenamos tus datos.

Laptop ←→ Your Cloudflare Worker ←→ Desktop
                  ↕
              Your Phone

Despliegas el centro de sincronización en tu propia cuenta de Cloudflare (nivel gratuito). Tu base de datos D1, tu clave de cifrado, tus datos. Nosotros proporcionamos el código: tú eres dueño de la infraestructura.

nmem sync              # push/pull changes
nmem sync --auto       # auto-sync after every remember/recall

La sincronización usa delta de Merkle: solo viajan los diffs, no el cerebro completo. Rápido, eficiente y privado.

Guía de configuración de Cloud Sync →


Características

Memoria y recuperación

  • 14 tipos de memoria — hecho, decisión, error, percepción, preferencia, flujo de trabajo, instrucción y más
  • Activación propagada — los recuerdos surgen por asociación, no por coincidencia de palabras clave
  • Razonamiento cognitivo — plantea hipótesis, presenta evidencia, haz predicciones, verifica con confianza bayesiana
  • Ajustes preestablecidos de carga — nmem config preset {balanced,safe-cost,max-recall,chat-heavy} ajusta el cerebro para SaaS, modo frugal, retención profunda o agentes conversacionales
  • Recuperación temporal — nmem_causal expone acciones de temporal_range y temporal_neighborhood; consulta la guía de Recetas de Recuperación Temporal

Ingestión de conocimiento

  • Entrena desde documentos — PDF, DOCX, PPTX, HTML, JSON, XLSX, CSV se incorporan como conocimiento permanente del cerebro
  • Adaptadores de importación — migra desde ChromaDB, Mem0, Cognee, Graphiti, LlamaIndex con un solo comando

Ciclo de vida y almacenamiento

  • Consolidación de memoria — los recuerdos episódicos maduran hasta convertirse en conocimiento semántico con el tiempo
  • Niveles de compresión — completo → resumen → esencia → fantasma → metadatos (recupera almacenamiento, conserva el significado)
  • Versionado del cerebro — instantánea, reversión, diff, trasplante de recuerdos entre cerebros

Comunidad

  • Brain Store — explora, importa y publica cerebros preconstruidos en el mercado comunitario
  • 3 cerebros semilla — Mejores Prácticas de Python, Flujos de Trabajo de Git, Esenciales de Docker (listos para importar)

Ecosistema

  • Panel web — interfaz React de 7 páginas con visualización de grafos, radar de salud, línea de tiempo, mapa mental y Brain Store
  • Extensión de VS Code — árbol de memoria, explorador de grafos, CodeLens, sincronización WebSocket (Marketplace →)
  • Seguridad — cifrado Fernet, detección automática de contenido sensible, SQL parametrizado, validación de rutas
  • Respaldo por Telegram — envía archivos .db del cerebro a Telegram para respaldo externo

Ejemplos rápidos

# Store memories (type auto-detected)
nmem remember "Fixed auth bug with null check in login.py:42"
nmem remember "We decided to use PostgreSQL" --type decision
nmem todo "Review PR #123" --priority 7

# Recall
nmem recall "auth bug"
nmem recall "database decision" --depth 2

# Brain management
nmem brain list && nmem brain health
nmem brain export -o backup.json

# Sync across devices
nmem sync --full

# Web dashboard
nmem serve    # http://localhost:8000/dashboard
import asyncio
from neural_memory import Brain
from neural_memory.storage import InMemoryStorage
from neural_memory.engine.encoder import MemoryEncoder
from neural_memory.engine.retrieval import ReflexPipeline

async def main():
    storage = InMemoryStorage()
    brain = Brain.create("my_brain")
    await storage.save_brain(brain)
    storage.set_brain(brain.id)

    encoder = MemoryEncoder(storage, brain.config)
    await encoder.encode("Met Alice to discuss API design")
    await encoder.encode("Decided to use FastAPI for backend")

    pipeline = ReflexPipeline(storage, brain.config)
    result = await pipeline.query("What did we decide about backend?")
    print(result.context)  # "Decided to use FastAPI for backend"

asyncio.run(main())

Neural Memory Pro

Neural Memory gratuito es completo: 63 herramientas, recuerdos ilimitados, totalmente offline. Nunca tienes que pagar.

Pero más allá de 10K recuerdos, las cosas cambian. La coincidencia de palabras clave no encuentra contenido semánticamente relacionado. La consolidación se ralentiza a minutos. El almacenamiento crece sin límite. Si el cerebro de tu agente está creciendo, Pro lo hace inteligente.

Gratis recupera por palabras clave. Pro recupera por significado.

Query: "authentication improvements"

Free (FTS5):  2 results — exact matches only
Pro  (HNSW):  7 results — includes "JWT rotation", "session hardening", "OAuth migration"

Qué añade Pro

Gratis (SQLite)Pro (InfinityDB)
RecuperaciónCoincidencia de palabras clave (FTS5)Similitud semántica (HNSW)
Velocidad con 1M de neuronas~500ms<5ms
Escala probada~50K neuronas2M+ neuronas
CompresiónRecorte a nivel de textoCompresión vectorial de 5 niveles (97% de ahorro)
ConsolidaciónFuerza bruta O(N²)Agrupación HNSW O(N×k)
Almacenamiento por 1M~5 GB~1 GB
Sincronización en la nubePush/pull manualDelta de Merkle (automático, solo diffs)

Características exclusivas de Pro

  • Consultas de cono — recuperación semántica ajustable. Estrecha el cono para precisión, amplíalo para exploración
  • Fusión inteligente — consolidación que escala a 1M+ neuronas mediante agrupación de vecinos HNSW
  • Compresión direccional — comprime a lo largo de múltiples ejes semánticos preservando el significado
  • Ciclo de vida automático de 5 niveles — los recuerdos fluyen de float32 → float16 → int8 → binario → metadatos. Promoción automática al acceder

Obtén Pro

pip install neural-memory                 # Pro features included
nmem shared activate --key NM-PRO-XXXX-XXXX-XXXX   # activate license
nmem shared status                                 # verify: Pro: Active

$9/mes — garantía de devolución de 30 días. Todas las herramientas gratuitas siguen funcionando. Degrada en cualquier momento, conserva tus datos.

Inicio rápido de Pro → · Comparación completa → · Precios →


Configuración por herramienta

Claude Code (Plugin)
/plugin marketplace add nhadaututtheky/neural-memory
/plugin install neural-memory@neural-memory-marketplace
Cursor / Windsurf / Otros clientes MCP
pip install neural-memory

Añade a la configuración MCP de tu editor:

{
  "mcpServers": {
    "neural-memory": { "command": "nmem-mcp" }
  }
}
OpenClaw (Skill o Plugin)

Skill: un clic vía ClawHub. Publicado en cada versión:

clawhub.ai/skills/neural-memory

Plugin: reemplazo de ranura de memoria. Úsalo si quieres que NeuralMemory sea el proveedor de memoria de OpenClaw en lugar de un skill que se invoca:

pip install neural-memory && npm install -g neuralmemory

Configura la ranura de memoria en ~/.openclaw/openclaw.json:

{ "plugins": { "slots": { "memory": "neuralmemory" } } }
Actualizar a Pro

¿Ya usas Neural Memory? Solo activa tu clave:

nmem shared activate --key NM-PRO-XXXX-XXXX-XXXX   # activate license

Luego habilita InfinityDB (motor de búsqueda semántica):

# ~/.neuralmemory/config.toml
storage_backend = "infinitydb"

Reinicia tu servidor MCP. Los recuerdos existentes se migran automáticamente de SQLite a InfinityDB en el primer arranque.

Obtén una licencia → · Inicio rápido de Pro →

Extras de instalación
pip install neural-memory[server]              # FastAPI server + dashboard
pip install neural-memory[extract]             # PDF/DOCX/PPTX/HTML/XLSX extraction
pip install neural-memory[nlp-vi]              # Vietnamese NLP
pip install neural-memory[embeddings]          # Local embedding models
pip install neural-memory[embeddings-openai]   # OpenAI embeddings
pip install neural-memory[all]                 # Everything
Benchmarks frente a alternativas
MétricaNeuralMemoryMem0Cognee
Escribir 50 recuerdos1.2s148.2s (121x más lento)290.6s (80x más lento)
Leer 20 consultas1.8s2.9s34.6s
Llamadas a API070149

Cero llamadas a LLM, cero costo de API. Benchmarks completos → · Evidencia de la versión de Eficiencia Cognitiva →


Documentación

GuíaDescripción
Guía de inicio rápidoGuía interactiva con demos animadas
Inicio rápido de ProComienza con las funciones de Pro
Referencia del CLILos 82 comandos del CLI
Referencia de herramientas MCPLas 63 herramientas MCP con parámetros
Cloud SyncConfiguración de sincronización multidispositivo
Guía de salud cerebralComprende y mejora la salud cerebral
Configuración de embeddingsConfigura proveedores de embeddings
ArquitecturaInmersión técnica en el diseño

Desarrollo

git clone https://github.com/nhadaututtheky/neural-memory
cd neural-memory && pip install -e ".[dev]"
nmem doctor --dev        # Verify contributor setup
pytest tests/ -v          # 7800+ tests
ruff check src/ tests/    # Lint

Consulta CONTRIBUTING.md para las pautas.

Soporte

Si Neural Memory ayuda a tu agente de IA a recordar, considera darle una estrella: ayuda a otros a descubrir el proyecto y mantiene el desarrollo en marcha.

Star on GitHub

También puedes patrocinar el proyecto.

Licencia

MIT — consulta LICENSE.