How leobaray/memoria works
memoria is a long-term, evidence-aware memory for an AI coding assistant. Messages trigger card recall; scheduled dream processing learns from Claude Code conversations, updates cards, derives deductions and lessons, and grades outcomes. Separate capabilities collect measured facts, answer questions with cited evidence, evaluate recall, import existing memories, replicate data, and provide a read-only UI. Cards and conversation history are plain files. Edges use excerpts, the SOURCE INDEX, or README statements; unsampled implementation details are not inferred.
Main entry points: mem.py JSON memory cards · sonho.py Dream consolidation · perguntar.py Reasoned answers · regua.py Recall evaluation
Components 20
Recall and answers
- Card recall
mem.py - Semantic search
sentido.py - Reasoned answers
perguntar.py - Conversation search
conversas.py
Learning and evaluation
- Dream consolidation
sonho.py - Conversation extraction
extrair.py - Measured collection
coleta.py - Recall evaluation
regua.py - Memory import
importar.py
Memory data
- JSON memory cards
mem.py - Card type templates
esqueletos - Raw conversations
conversas.py - History and diary
sonho.py
Operations and visibility
- Memory replication
replica.py - Read-only memory UI
ui.py
Other components
- AI assistant
- User messages
- Claude model
- Ollama embeddings
- Honcho memory
Connections 28
- User messages → Card recall: triggers
README.md - Card recall → AI assistant: returns context
README.md - Card recall → JSON memory cards: reads cards
mem.py - Card recall → Semantic search: searches by meaning
mem.py - Semantic search → Ollama embeddings: requests embeddings
sentido.py - Reasoned answers → Card recall: requests package
perguntar.py - Reasoned answers → Semantic search: finds similar cards
perguntar.py - Reasoned answers → Conversation search: finds similar turns
perguntar.py - Reasoned answers → Claude model: prompts answer
perguntar.py - Reasoned answers → AI assistant: returns answer
README.md - Conversation search → Raw conversations: indexes and searches
conversas.py - Dream consolidation → Conversation extraction: reads new turns
README.md - Dream consolidation → Raw conversations: learns from conversations
README.md - Dream consolidation → Claude model: requests consolidation
sonho.py - Dream consolidation → JSON memory cards: updates cards
sonho.py - Dream consolidation → History and diary: records history
sonho.py - Dream consolidation → JSON memory cards: deduces and rewards
README.md - Dream consolidation → JSON memory cards: derives lessons
README.md - Measured collection → JSON memory cards: writes measurements
coleta.py - Recall evaluation → Card recall: tests retrieval
regua.py - Recall evaluation → Honcho memory: compares optionally
regua.py - Recall evaluation → Reasoned answers: grades answers
README.md - Memory import → JSON memory cards: imports facts
importar.py - Memory import → Honcho memory: reads conclusions
importar.py - Card type templates → JSON memory cards: defines card fields
README.md - Memory replication → JSON memory cards: synchronizes data
replica.py - Read-only memory UI → JSON memory cards: displays cards
ui.py - Read-only memory UI → History and diary: displays activity
ui.py