sachitrafa/yourmemoryMemória de IA agêntica com decaimento pela curva de esquecimento de Ebbinghaus. +16pp melhor recall que Mem0 no LoCoMo.
Memória persistente e auto-melhorável para agentes de IA — construída com base na ciência de como os humanos lembram.
Todas as manhãs o seu agente de IA trata-o como um estranho. O mesmo contexto reexplicado. As mesmas preferências esquecidas. Cada sessão começa do zero.
A maioria das ferramentas de "memória" junta uma base de dados vetorial a um agente e diz que está pronto — mas isso é apenas armazenamento. Acumula todos os quase-duplicados até que a recuperação se afogue em ruído. Um peixinho dourado com um aquário maior.
YourMemory é diferente: memória que funciona como um cérebro, não como uma base de dados.
flowchart LR
A["🧠 You tell your<br/>AI something"] --> B["Extract durable<br/>facts"]
B --> C["Dedup + embed<br/>+ graph-link"]
C --> D[("Memory<br/>store")]
D -->|"related facts pile up"| E["✨ Consolidate<br/>N → 1 summary"]
D -->|"stale + unused"| F["📉 Decay<br/>+ prune"]
D -->|"new session"| G["♻️ Recall<br/>hybrid + graph"]
E --> D
G --> H["🤖 Your agent<br/>picks up where<br/>it left off"]
style D fill:#0a2540,stroke:#19cdff,color:#fff
style E fill:#0c2b3a,stroke:#5eead4,color:#fff
style H fill:#0c2b3a,stroke:#19cdff,color:#fff
| Funcionalidade | O que faz | |
|---|---|---|
| 🧠 | Consolidação | Quando factos relacionados suficientes se acumulam, são comprimidos num resumo limpo e os originais são arquivados. A memória torna-se mais nítida ao longo do tempo, não inchada. |
| 📉 | Decaimento biológico | Cada memória envelhece numa curva de esquecimento de Ebbinghaus. Factos obsoletos e não utilizados desaparecem; os importantes e frequentemente recordados persistem. |
| 🔗 | Grafo de entidades | As memórias ligam-se por pessoas, lugares e conceitos partilhados — para que a recordação revele o que esqueceu de pedir. |
| ♻️ | Sobrevive a reinicializações de contexto | Quando a janela de contexto se compacta, o YourMemory devolve o contexto de trabalho — sem reler ficheiros para descobrir onde estava. |
| 🔒 | Registo de auditoria à prova de adulteração | Cada leitura/escrita/eliminação é registada num livro-razão com cadeia de hash. Altere um registo e a cadeia quebra. |
| 👥 | Pools de memória de equipa | Memória partilhada baseada em funções, para que os agentes de toda uma equipa recorram ao mesmo conhecimento institucional — com memórias privadas mantidas privadas. |
| 🛡️ | Direitos de dados integrados | Exportação com um comando (direito de acesso) e direito ao esquecimento (purga), além de controlos alinhados com SOC 2. |
| 🔌 | Nativo MCP e local-first | Funciona com Claude, Cursor, Cline, Windsurf ou qualquer cliente MCP. Executa inteiramente na sua máquina — sem chave de API, nada sai do seu sistema. |
Um comando para instalar. DuckDB por defeito (zero configuração), Postgres + pgvector para equipas.
Três conjuntos de dados externos. Cada número é independentemente reproduzível — o código de benchmark está no repositório. Metodologia completa em BENCHMARKS.md.
xychart-beta
title "Recall@5 · LoCoMo-10 (higher is better)"
x-axis ["Mem0", "Zep Cloud", "Supermemory", "YourMemory"]
y-axis "Recall@5 percent" 0 --> 70
bar [18, 28, 31, 59]
2× melhor recall que o Zep Cloud em todas as 10 amostras. *Supermemory e Mem0 esgotaram as quotas gratuitas a meio do benchmark; pontuações calculadas sobre os 1.534 pares completos.
O benchmark padrão mais difícil para memória de longo prazo. Cada pergunta está enterrada em ~53 sessões.
| Métrica | Pontuação |
|---|---|
| Recall@5 (qualquer sessão dourada no top-5) | 89.4% |
| Recall-all@5 (todas as sessões douradas no top-5) | 84.8% |
| nDCG@5 (qualidade da classificação) | 87.4% |
| Sistema | BOTH_FOUND@5 |
|---|---|
| YourMemory (vetor + BM25 + grafo de entidades) | 71.5% |
| YourMemory (sem arestas de entidades) | 59.5% |
As arestas do grafo de entidades adicionam +12 pp — percorrem do Facto 1 ao Facto 2 mesmo quando o Facto 2 tem baixa similaridade de embedding com a consulta.
Artigo: Construí decaimento de memória para agentes de IA usando a curva de esquecimento de Ebbinghaus
Python 3.11–3.14. Sem Docker, sem configuração de base de dados. Toda a memória armazenada localmente em ~/.yourmemory/.
pip install yourmemory
yourmemory-register <your-token>
yourmemory-setup
Obtenha o seu token: visite yourmemoryai.xyz → insira o seu email → verifique com um código de 6 dígitos → copie o seu token.
yourmemory-setup deteta automaticamente e configura Claude Code, Claude Desktop, Cursor, Windsurf e Cline, depois pergunta qual backend usar:
DATABASE_URL (precisa da extensão pgvector)