Pedro-Bianco/pi-memory

Memória de longo prazo para agentes de IA
aprende com a conversa, lembra na próxima sessão e cita de onde veio cada resposta
Instalação ·
Uso ·
CLI, HTTP e MCP ·
Resultados ·
Guia completo ·
Notebooks
Execução real: Ollama qwen2.5:14b com os motores padrão; falas e decisões sem edição (as respostas do assistente na sessão 1 foram omitidas para caber).
93% decisões de memória certas (54/58, qwen2.5:14b )
0 memórias apagadas por engano
96% trecho certo no top 3 com citação de página
Local sem chave e sem telemetria na configuração padrão
Números de execuções registradas em eval/results/ , com dados fictícios.
> In English. pi-memory is a Python library that gives any AI assistant long-term memory: it
> extracts facts from conversations and decides to add, update, delete or ignore each one
> (93% correct on 58 recorded cases with a local qwen2.5:14b, zero wrong deletions). It also
> keeps a document knowledge base with hybrid search and page-level citations, plus a topic graph.
> Local by default (FastEmbed + Ollama + Qdrant), every engine is pluggable, and the same JSON is
> served as a library, CLI, HTTP server with a local admin page, and MCP server. Docs are in
> Brazilian Portuguese.
## Documentação
Guia completo: o problema que o projeto resolve, conceitos,
arquitetura, como a memória decide, busca híbrida, referência da API, formatos JSON, motores,
limites e perguntas frequentes.
Notebooks executados: memória, documentos, um agente real com
memória (duas sessões), um agente com ferramentas de memória, troca de motores, grafo e
administração.
llms.txt: índice curto para modelos de linguagem e agentes de código.
## O que faz
Memória de longo prazo: recebe uma conversa, extrai os fatos sobre a pessoa com um modelo
de linguagem e decide, para cada fato, se guarda, substitui uma memória antiga,
apaga uma que deixou de ser verdade ou ignora (já sabia). Na dúvida, guarda: nunca
apaga por palpite.
Base de documentos: PDF, Word (.docx), planilhas (.xlsx, .csv), apresentações (.pptx) e
texto (.txt, .md). Busca por significado e por palavra exata (códigos como NF-4521), e
cada resultado diz de onde veio: “contrato.pdf, página 12”, “vendas.xlsx, aba Vendas,
linhas 1–5”, “apresentacao.pptx, slide 3 (notas)”.
Peças trocáveis: embedding, modelo de linguagem, banco vetorial, leitores de documento,
divisão em trechos e prompts ficam atrás de interfaces pequenas. Também aceita qualquer função
texto -> texto como modelo de linguagem.
Coleções e administração: documentos organizados em coleções (contratos, manuais...);
dá para ver e apagar coleções inteiras, documentos e trechos, criar documentos digitando o
texto e ver a visão geral de cada dono.
Linha de comando, HTTP e MCP: as mesmas operações da biblioteca, com o mesmo JSON, para
usar de qualquer linguagem, do terminal ou de um agente de IA.
Administração local no navegador: pi-memory serve-http abre em http://127.0.0.1:8765/
uma página para ver e controlar memórias, coleções, documentos, trechos, busca e grafo, só na
sua máquina.
Cada dono separado: toda operação recebe um owner; memórias e documentos de um não
aparecem para outro (testado nas 22 operações, em todos os transportes e bancos). Quem