NeuraKeep

Infraestructura de memoria auditable y con citas de fuentes para agentes de IA, con detección de conflictos, revisión de propuestas y memoria de fallos reutilizable.

GitHub
2
Prueba este MCPPatrocinado

Documentación

NeuraKeep

NeuraKeep es un sistema de memoria local-first para agentes de IA.

Proporciona a Claude Desktop, Claude Code, Codex, OpenClaw, herramientas tipo Cursor y otros clientes MCP una capa de memoria compartida con citas de fuentes que se ejecuta en tu propia máquina.

Qué hace

  • Importa Markdown, texto, JSONL y PDFs a un vault local
  • Conserva las fuentes originales y extrae propuestas de memoria citadas
  • Te permite revisar la memoria antes de que se vuelva duradera
  • Busca entre fuentes, hechos, eventos, fallos y decisiones
  • Muestra un grafo de memoria relacionada con expansión progresiva
  • Expone herramientas MCP para agentes:
    • memory_search
    • memory_read
    • memory_explain_sources
    • memory_propose_update
    • memory_apply_update

La regla principal es simple: los agentes pueden proponer memoria, pero la memoria duradera debe ser revisable y estar citada con fuentes.

Instalación local

Requisitos:

  • Node.js 20+
  • npm

Instala la CLI publicada:

npm install -g neurakeep
neurakeep init --root .umos
neurakeep mcp --root .umos

npm install
npm run build:all
node dist/cli/index.js init --root .umos
node dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui --read-write

Abre:

http://127.0.0.1:8765/index.html

Ejemplos de CLI

node dist/cli/index.js ingest README.md --root .umos --kind markdown --space personal --trust-level trusted --origin manual --sensitivity internal
node dist/cli/index.js search "what should my agents remember?" --root .umos --space personal --neighbors 1
node dist/cli/index.js propose latest --root .umos
node dist/cli/index.js apply <proposal-id> --root .umos
node dist/cli/index.js mcp --root .umos

Configuración local de MCP

Ejemplo de configuración MCP stdio:

{
  "command": "node",
  "args": [
    "C:/path/to/neurakeep/dist/cli/index.js",
    "mcp",
    "--root",
    "C:/path/to/neurakeep/.umos"
  ]
}

Modo HTTP local:

node dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui

Usa --token o NEURAKEEP_MCP_TOKEN antes de exponer cualquier endpoint HTTP fuera de tu máquina.

Alcance de código abierto

Este repositorio es el núcleo local y autogestionado de NeuraKeep: CLI, vault local, interfaz local, MCP local, importaciones, búsqueda, grafo, revisión de propuestas y herramientas de calidad de memoria.

Documentación

Comprobaciones de desarrollo

npm run typecheck
npm run build:all
npm test
npm run e2e

Licencia

Apache-2.0