NeuraKeep

Infraestrutura de memória auditável e com citação de fontes para agentes de IA, com detecção de conflitos, revisão de propostas e memória de falhas reutilizável.

GitHub
2
Experimente este MCPPatrocinado

Documentação

NeuraKeep

O NeuraKeep é um sistema de memória local-first para agentes de IA.

Ele oferece ao Claude Desktop, Claude Code, Codex, OpenClaw, ferramentas estilo Cursor e outros clientes MCP uma camada de memória compartilhada, com citação de fontes, que roda na sua própria máquina.

O Que Ele Faz

  • Importa Markdown, texto, JSONL e PDFs para um vault local
  • Preserva as fontes brutas e extrai propostas de memória citadas
  • Permite revisar a memória antes que ela se torne durável
  • Busca em fontes, fatos, eventos, falhas e decisões
  • Exibe um grafo de memória relacionada com expansão progressiva
  • Expõe ferramentas MCP para agentes:
    • memory_search
    • memory_read
    • memory_explain_sources
    • memory_propose_update
    • memory_apply_update

A regra central é simples: agentes podem propor memória, mas memória durável deve ser revisável e citada por fonte.

Instalação Local

Pré-requisitos:

  • Node.js 20+
  • npm

Instale a 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

Abra:

http://127.0.0.1:8765/index.html

Exemplos 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

Configuração MCP Local

Exemplo de configuração 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

Use --token ou NEURAKEEP_MCP_TOKEN antes de expor qualquer endpoint HTTP fora da sua máquina.

Escopo do Open Source

Este repositório é o núcleo local e autogerenciado do NeuraKeep: CLI, vault local, UI local, MCP local, importações, busca, grafo, revisão de propostas e ferramentas de qualidade de memória.

Documentação

Verificações de Desenvolvimento

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

Licença

Apache-2.0