Neural Memory

NeuralMemory

Seu agente de IA esquece tudo entre sessões. O Neural Memory dá a ele um cérebro.

Website · Quickstart · Ferramentas MCP · Pro · Changelog

As memórias são armazenadas como neurônios interconectados e recuperadas por meio de ativação por propagação — da mesma forma que o cérebro humano funciona. Sem banco de dados vetorial. Sem chamadas de API. Sem fatura mensal de embeddings.

pip install neural-memory

Reinicie sua ferramenta de IA. Seu agente agora lembra — sem necessidade de init, o servidor MCP inicializa automaticamente no primeiro uso.

Já instalou? O nmem update atualiza no local e detecta se você instalou via pip ou a partir do código-fonte. O nmem update --check apenas informa o que está disponível.

O CLI é nmem (ou a forma mais longa neural-memory). Não existe binário nm.

3 Ferramentas. Só Isso.

63 ferramentas MCP estão disponíveis, mas você só precisa de três:

Todo o resto — sessões, carregamento de contexto, rastreamento de hábitos, manutenção — funciona de forma transparente em segundo plano.

Todas as 63 ferramentas MCP →

O Que Torna Isso Diferente

A maioria das ferramentas de memória são mecanismos de busca. O Neural Memory é um grafo que pensa.

Quando você pergunta "Por que a interrupção de terça-feira aconteceu?", um banco de dados vetorial retorna a frase mais semelhante. O Neural Memory rastreia a cadeia:

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

Os relacionamentos são explícitos — CAUSED_BY, LEADS_TO, RESOLVED_BY, CONTRADICTS — para que seu agente não apenas encontre memórias, mas raciocine por meio delas.

Sincronização na Nuvem — Seus Dados, Sua Infraestrutura

Sincronize seu cérebro em todas as máquinas. Diferente de outras ferramentas de memória, nunca armazenamos seus dados.

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

Você implanta o hub de sincronização na sua própria conta Cloudflare (plano gratuito). Seu banco de dados D1, sua chave de criptografia, seus dados. Nós fornecemos o código — você é dono da infraestrutura.

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

A sincronização usa delta Merkle — apenas as diferenças trafegam, não o cérebro inteiro. Rápido, eficiente e privado.

Guia de configuração da Sincronização na Nuvem →

Recursos

Memória e Recuperação

• 14 tipos de memória — fato, decisão, erro, insight, preferência, fluxo de trabalho, instrução e mais
• Ativação por propagação — memórias surgem por associação, não por correspondência de palavras-chave
• Raciocínio cognitivo — formular hipóteses, apresentar evidências, fazer previsões, verificar com confiança bayesiana
• Predefinições de carga de trabalho — nmem config preset {balanced,safe-cost,max-recall,chat-heavy} ajustam o cérebro para SaaS, modo econômico, retenção profunda ou agentes conversacionais
• Recuperação temporal — nmem_causal expõe ações de temporal_range e temporal_neighborhood; veja o guia Receitas de Recuperação Temporal

Ingestão de Conhecimento

• Treine a partir de documentos — PDF, DOCX, PPTX, HTML, JSON, XLSX, CSV ingeridos no conhecimento permanente do cérebro
• Adaptadores de importação — migre de ChromaDB, Mem0, Cognee, Graphiti, LlamaIndex com um único comando

Ciclo de Vida e Armazenamento

• Consolidação de memória — memórias episódicas amadurecem em conhecimento semântico ao longo do tempo
• Camadas de compressão — completo → resumo → essência → fantasma → metadados (recupere armazenamento, mantenha o significado)
• Versionamento do cérebro — snapshot, rollback, diff, transplante de memórias entre cérebros

Comunidade

• Brain Store — navegue, importe e publique cérebros pré-construídos no marketplace da comunidade
• 3 cérebros iniciais — Melhores Práticas em Python, Fluxos de Trabalho Git, Fundamentos de Docker (prontos para importar)

Ecossistema

• Painel web — interface React de 7 páginas com visualização de grafo, radar de saúde, linha do tempo, mapa mental, Brain Store
• Extensão VS Code — árvore de memória, explorador de grafo, CodeLens, sincronização WebSocket (Marketplace →)
• Segurança — criptografia Fernet, detecção automática de conteúdo sensível, SQL parametrizado, validação de caminhos
• Backup via Telegram — envie arquivos .db do cérebro para o Telegram para backup externo

Exemplos 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

O Neural Memory gratuito é completo — 63 ferramentas, memórias ilimitadas, totalmente offline. Você nunca precisa pagar.

Mas acima de 10 mil memórias, as coisas mudam. A correspondência por palavras-chave não encontra conteúdo semanticamente relacionado. A consolidação fica lenta, levando minutos. O armazenamento cresce sem limites. Se o cérebro do seu agente está ficando grande, o Pro o torna inteligente.

O gratuito recupera por palavras-chave. O 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"

O que o Pro adiciona

Recursos exclusivos do Pro

• Cone Queries — recuperação semântica ajustável. Estreite o cone para precisão, alargue para exploração
• Smart Merge — consolidação que escala para 1M+ neurônios usando agrupamento de vizinhos HNSW
• Compressão Direcional — comprima ao longo de múltiplos eixos semânticos preservando o significado
• Ciclo de vida automático em 5 camadas — memórias fluem de float32 → float16 → int8 → binário → metadados. Promoção automática no acesso

Obtenha o 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/mês — garantia de reembolso de 30 dias. Todas as ferramentas gratuitas continuam funcionando. Faça downgrade a qualquer momento, mantenha seus dados.

Quickstart do Pro → · Comparação completa → · Preços →

Configuração por Ferramenta

/plugin marketplace add nhadaututtheky/neural-memory
/plugin install neural-memory@neural-memory-marketplace

pip install neural-memory

{
  "mcpServers": {
    "neural-memory": { "command": "nmem-mcp" }
  }
}

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

{ "plugins": { "slots": { "memory": "neuralmemory" } } }

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

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

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

Documentação

Desenvolvimento

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

Consulte CONTRIBUTING.md para diretrizes.

Suporte

Se o Neural Memory ajuda seu agente de IA a lembrar, considere dar uma estrela — isso ajuda outras pessoas a descobrirem o projeto e mantém o desenvolvimento ativo.

Você também pode patrocinar o projeto.

Licença

MIT — consulte LICENSE.