ERINYS
ERINYS — Memoria reflexiva para agentes de IA
A partir de recuerdos que existieron, incluso crea recuerdos que nunca existieron.
Los sistemas de memoria para agentes de IA siempre han imitado la memoria humana. A corto plazo, a largo plazo, episódica, semántica: categorías de libro de texto aplicadas directamente a las implementaciones.
Algo siempre se sentía mal.
Los humanos olvidan. Pero los sistemas de memoria existentes no. Crecen sin cesar, sirviendo hechos obsoletos con el mismo peso que los frescos. Los humanos notan: "espera, ¿no dijiste algo diferente antes?". Pero los sistemas de memoria sobrescriben silenciosamente. Los humanos conectan dos experiencias no relacionadas y piensan: "oh, puedo usar eso aquí". Pero los sistemas de memoria solo almacenan y recuperan.
Lo que necesitaba ser imitado no era la taxonomía de la memoria. Era el comportamiento.
Esa incomodidad es lo que invocó a ERINYS.
ERINYS es un perro guardián. Recuerda, olvida, cuestiona y muerde.
Qué hace diferente a ERINYS
Olvido. La mayoría de los sistemas de memoria solo acumulan. ERINYS degrada los recuerdos con el tiempo siguiendo la curva del olvido de Ebbinghaus. El ruido antiguo se hunde. El conocimiento accedido frecuentemente flota. Los resultados de búsqueda se mantienen relevantes sin curación manual.
Destilación. Una corrección de errores específica ("faltaba la bandera JWT httpOnly") genera automáticamente tres capas: el hecho concreto → un patrón reutilizable ("los nuevos endpoints necesitan una lista de verificación de seguridad") → un principio universal ("los valores predeterminados de seguridad deben ser seguros sin necesidad de activación"). Ningún otro sistema de memoria hace esto.
Ciclo de ensueño. Dos recuerdos se envían a un LLM: "¿hay alguna conexión?". Los pares candidatos se seleccionan por similitud semántica: lo suficientemente cerca como para estar relacionados (coseno > 0.65), lo suficientemente lejos como para no ser redundantes (< 0.90). Programado durante la noche mediante cron, encuentra conexiones que nunca pensarías en buscar. Sin magia, solo comparación automatizada de notas a escala.
Related MCP server: cell-mem
Filosofía de diseño
La memoria tiene capas
No toda la memoria es igual. ERINYS organiza el conocimiento por nivel de abstracción:
Concreto — lo que sucedió. "Faltaba la bandera JWT httpOnly en
/api/auth."Abstracto — patrones a partir de hechos. "Los nuevos endpoints de API necesitan una lista de verificación de encabezados de seguridad."
Meta — principios a partir de patrones. "Los valores predeterminados de seguridad deben ser seguros sin activación manual."
Una sola corrección de errores genera los tres a través de la destilación. La capa meta acumula principios que se transfieren entre proyectos y pilas tecnológicas.
El olvido es una característica
Cada recuerdo tiene una puntuación de fuerza que decae con el tiempo. Un recuerdo guardado hace 6 meses tiene un rango inferior a uno guardado ayer. Los recuerdos accedidos frecuentemente resisten la degradación: la recuperación repetida los refuerza.
Cuando la fuerza cae por debajo de un umbral, el recuerdo se convierte en un candidato para la poda. La base de datos se mantiene ligera. La búsqueda se mantiene relevante.
Los hechos cambian. La historia no debería desaparecer
Cuando la información se actualiza ("nos mudamos de AWS a GCP"), ERINYS no sobrescribe. Crea una cadena de reemplazo: el hecho antiguo se marca como reemplazado pero se conserva. Puedes preguntar "¿qué creíamos en marzo?" y obtener la respuesta que era cierta entonces.
Las contradicciones deben ser detectadas
Si la memoria contiene tanto "usar PostgreSQL" como "usar SQLite", ERINYS detecta el conflicto. En lugar de cambiar silenciosamente, el agente pregunta: "anteriormente elegiste PostgreSQL, ¿ha cambiado el requisito?".
La búsqueda encuentra significado, no solo palabras clave
Dos búsquedas se ejecutan simultáneamente y fusionan los resultados:
Búsqueda por palabras clave (FTS5) — coincidencia exacta de términos.
Búsqueda vectorial (sqlite-vec) — similitud semántica. "autenticación" encuentra "inicio de sesión", "JWT", "tokens de sesión".
Los resultados se fusionan mediante Reciprocal Rank Fusion (RRF). Alto en ambos = puntuación más alta.
Todo permanece local
Archivo SQLite único. Sin APIs en la nube. Sin claves de API. Sin suscripciones. Capaz de funcionar sin conexión. La memoria de tu agente nunca sale de tu máquina.
Casos de uso
1. Memoria entre sesiones para agentes de codificación
# Agent saves a learning after fixing a bug
erinys_save(
title="Fixed JWT httpOnly flag missing",
content="Cookie was accessible via JS. Added httpOnly: true, secure: true, sameSite: strict.",
type="bugfix",
project="my-app"
)
# Next week, similar task — agent searches memory
erinys_search(query="authentication cookie security", project="my-app")
# → Returns the JWT fix with relevance score2. Detección de contradicciones
erinys_save(title="Database choice", content="Using SQLite for simplicity", project="my-app")
erinys_conflict_check(observation_id=42)
# → "⚠️ Conflicts with #18: 'Using PostgreSQL for production reliability'"3. Ciclo de ensueño — Síntesis de conocimiento nocturna
erinys_dream(max_collisions=10)
# Picks memory pairs in the "sweet spot" (cosine 0.65–0.90)
# Memory A: "RTK reduces token usage by 60-90%"
# Memory B: "Bootstrap Gate takes 3 seconds due to multiple script calls"
# → Insight: "Apply RTK prefix to Bootstrap Gate scripts to reduce overhead"4. Consultas temporales
erinys_timeline(query="deployment target", as_of="2026-03-01")
# → "AWS EC2 (decided 2026-02-15)"
erinys_timeline(query="deployment target", as_of="2026-04-01")
# → "GCP Cloud Run (superseded AWS on 2026-03-20)"5. Destilación de conocimiento
erinys_save(title="Forgot CORS headers on new endpoint", type="bugfix", ...)
erinys_distill(observation_id=50, level="meta")
# → concrete: "CORS headers missing on /api/v2/users endpoint"
# → abstract: "New API endpoints need a CORS review checklist"
# → meta: "Security concerns should be opt-out, not opt-in"6. Exportación a Obsidian
erinys_export(format="markdown")
# → Generates .md files with [[wikilinks]]
# Drop into Obsidian → instant knowledge graphInicio rápido
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
# Run as MCP server (stdio)
python -m erinys_memory.server
# Run tests
PYTHONPATH=src pytest tests/ -vConfiguración de MCP
Claude Desktop / Claude Code
{
"mcpServers": {
"erinys": {
"command": "/path/to/ERINYS-mem/.venv/bin/python3",
"args": ["-m", "erinys_memory.server"],
"env": {
"ERINYS_DB_PATH": "~/.erinys/memory.db"
}
}
}
}Gemini (Antigravity)
Añadir a ~/.gemini/antigravity/settings.json bajo mcpServers:
{
"erinys": {
"command": "/path/to/ERINYS-mem/.venv/bin/python3",
"args": ["-m", "erinys_memory.server"],
"env": {
"ERINYS_DB_PATH": "~/.erinys/memory.db"
}
}
}Variables de entorno
Variable | Predeterminado | Descripción |
|
| Ruta de la base de datos SQLite |
|
| Modelo fastembed |
Herramientas (25)
Núcleo
erinys_save— Guardar observación (con upsert de topic_key)erinys_get— Obtener por ID (contenido completo, sin truncar)erinys_update— Actualización parcialerinys_delete— Eliminar con cascada FKerinys_search— Búsqueda híbrida RRF (FTS5 + vector)erinys_save_prompt— Guardar prompt del usuarioerinys_recall— Observaciones recienteserinys_context— Recuperación de contexto de sesiónerinys_export— Exportación markdown compatible con Obsidianerinys_backup— Copia de seguridad de SQLiteerinys_stats— Estadísticas de la base de datos
Grafo
erinys_link— Crear borde tipadoerinys_traverse— Recorrido de grafo BFSerinys_prune— Podar bordes débiles/degradados
Temporal
erinys_reinforce— Aumentar la fuerza de la observaciónerinys_supersede— Versionar una observaciónerinys_timeline— Consultar según marca de tiempoerinys_conflict_check— Detectar contradicciones
Ciclo de ensueño
erinys_collide— Colisionar dos observaciones mediante LLMerinys_dream— Ciclo de colisión por lotes
Destilación
erinys_distill— Abstracción de 3 granularidades (concreto → abstracto → meta)
Lotes y Evaluación
erinys_batch_save— Guardado masivo con enlace automáticoerinys_eval— Métricas de calidad inspiradas en LOCOMO
Sesión
erinys_session_start— Iniciar sesiónerinys_session_end— Finalizar sesión con resumenerinys_session_summary— Guardar resumen estructurado
Cómo se compara ERINYS
Característica | ERINYS | Mem0 | Memoria MCP oficial |
Búsqueda híbrida (palabra clave + vector) | ✅ FTS5 + sqlite-vec RRF | ✅ Vector + grafo | ❌ Solo grafo de conocimiento |
Olvido por decaimiento temporal | ✅ Curva de Ebbinghaus | ⚠️ Puntuación de prioridad | ❌ |
Destilación de 3 niveles (concreto → abstracto → meta) | ✅ | ❌ | ❌ |
Ciclo de ensueño (perspectiva basada en colisión) | ✅ | ❌ | ❌ |
Detección de contradicciones | ✅ | ⚠️ Sobrescribe mediante resolvedor | ❌ |
Consultas temporales ("¿qué creíamos en marzo?") | ✅ Cadena de reemplazo | ⚠️ Invalidación de grafo | ❌ |
Local-first (sin API en la nube) | ✅ Archivo único SQLite | ❌ Predeterminado en la nube | ✅ |
Exportación a Obsidian | ✅ [[wikilinks]] | ❌ | ❌ |
Auto-destilación al guardar | ✅ | ❌ | ❌ |
Nativo MCP | ✅ 25 herramientas | ✅ | ✅ |
Autoevaluación (métricas LOCOMO) | ✅ | ❌ | ❌ |
TL;DR — La mayoría de los servidores de memoria almacenan y recuperan. ERINYS también olvida, destila y sueña.
Arquitectura
┌──────────────────────────┐
│ FastMCP Server │ 25 tools, unified envelope
├──────────────────────────┤
│ search.py │ graph.py │ RRF hybrid │ typed edges
│ decay.py │ session.py │ Ebbinghaus │ lifecycle
│ temporal.py│collider.py │ versioning │ cross-pollination
│ distill.py │ db.py │ abstraction│ SQLite + vec
├──────────────────────────┤
│ embedding.py │ fastembed (BAAI/bge-small-en-v1.5)
├──────────────────────────┤
│ SQLite + FTS5 + vec0 │ Local-first, no network at runtime
└──────────────────────────┘Hoja de ruta
[ ] Demonio de ensueño — Ejecución automática en segundo plano del Ciclo de ensueño
[x] Auto-destilación al guardar — Activar destilación de 3 granularidades en cada guardado
[ ] Auto-poda — GC de observaciones degradadas cuando la BD excede el umbral de tamaño
[ ] CLI lista para Cron —
erinys dream --max 10para síntesis nocturna programada[ ] Paquete PyPI —
pip install erinys-memory[ ] Soporte multi-agente — Memoria con alcance por identidad de agente
Licencia
MIT
Available Tools
29 toolserinys_backfillErinys BackfillC
Plan or apply bounded historical records with event-ledger idempotency.
Inputs: items (required), run_key (required), mode, expected_plan_digest, +1 more. Returns: object
erinys_backupErinys BackupC
Create a consistent SQLite backup and return backup metadata.
Inputs: path. Returns: object
erinys_batch_saveErinys Batch SaveC
Bulk-add observations with automatic similarity linking.
Inputs: items (required), auto_link. Returns: object
erinys_collideErinys CollideC
Manually collide two observations to generate insight.
Inputs: obs_a_id (required), obs_b_id (required). Returns: object
erinys_conflict_checkErinys Conflict CheckC
Detect contradicting observations.
Inputs: observation_id (required). Returns: object
erinys_contextErinys ContextC
Get recent session context for a project.
Inputs: project (required), limit, intended_use. Returns: object
erinys_deleteErinys DeleteB
Delete an observation and cascade dependent rows via FK rules.
Inputs: id (required). Returns: object
erinys_distillErinys DistillC
Distill observation to higher abstraction level.
Inputs: observation_id (required), level. Returns: object
erinys_dreamErinys DreamC
Run Dream Cycle: batch collision of candidate memory pairs.
Inputs: max_collisions. Returns: object
erinys_evalErinys EvalC
Self-evaluate memory quality (LOCOMO-inspired metrics).
Inputs: project. Returns: object
erinys_exportErinys ExportC
Export observations as markdown payload (Obsidian-compatible [[wikilinks]]).
Inputs: format, project. Returns: object
erinys_forgetErinys ForgetA
VMG Verified Forgetting: 観測とその distilled 派生物を全 DB substrate から 削除し、不在を membership test で実証する。
forgetting は派生物に伝播する: distilled 子孫を含む closure ごと忘れる (子に親の情報が残るのを防ぐ)。closure を leaf-first で単一Txで削除し、 observations/vec/FTS(トリガ)/edges/collisions(CASCADE) を消す。 erinys_delete と違い、子を持つ親も忘れられる(NO ACTION FK を closure で解消)。 dry_run(既定)では削除せず closure と現在の在席のみ返す。
範囲外(正直な明示): Obsidian 書庫は次回 export の orphan 掃除で遅延除去、 .bak バックアップは復元用に設計上保持するため、この DB 検証の対象外。
Inputs: id (required), dry_run. Returns: object
erinys_getErinys GetB
Get a single observation by ID (full content, untruncated).
Inputs: id (required), intended_use. Returns: object
erinys_lineageErinys LineageB
VMG Provenance Visibility: 記憶の出自系譜を祖先方向に辿って返す。
各ノードの provenance.parents(無ければ distilled_from)を辿り、 どの記憶からどう派生したかの lineage-complete な鎖を構成する。
Inputs: id (required), max_depth. Returns: object
erinys_linkErinys LinkC
Create typed edge between observations.
Inputs: relation (required), source_id (required), target_id (required), weight. Returns: object
erinys_pruneErinys PruneC
Prune decayed observations below threshold.
Inputs: dry_run, threshold. Returns: object
erinys_recallErinys RecallC
Recall recent observations for context.
Inputs: limit, project, intended_use. Returns: object
erinys_reinforceErinys ReinforceC
Reinforce an observation by updating access_count and last_accessed.
Inputs: observation_id (required). Returns: object
erinys_saveErinys SaveB
Save a structured observation to ERINYS memory.
principal: この記憶を書いた主体(例 claude-opus-4-8 / codex)。省略時は env ERINYS_PRINCIPAL → "unknown"。VMG provenance に記録される。
P0-7 (opt-in): allowed_projects / allowed_scopes は書き込み許可の access gate。明示引数 > env(ERINYS_ALLOWED_PROJECTS / ERINYS_ALLOWED_SCOPES)> 無効(None)。どれも設定されなければ従来どおり無条件に保存する。許可外の project/scope への書き込みは POLICY_DENIED で拒否する。
Inputs: title (required), content (required), type, scope, +8 more. Returns: object
erinys_save_promptErinys Save PromptC
Save a user prompt to track intent and goals.
Inputs: content (required), project, session_id. Returns: object
erinys_searchErinys SearchC
RRF hybrid search (FTS5 keyword + vector similarity).
P0-7 (opt-in): allowed_projects / allowed_scopes は取得許可の access gate。 明示引数 > env(ERINYS_ALLOWED_PROJECTS / ERINYS_ALLOWED_SCOPES)> 無効 (None)。設定時は、許可外の project/scope の行を結果から除外する(global scope は常に可視)。どれも設定されなければ従来どおり全件返す。
Inputs: query (required), limit, project, principal, +6 more. Returns: object
erinys_session_endErinys Session EndC
End a session with optional summary.
Inputs: id (required), summary. Returns: object
erinys_session_startErinys Session StartC
Start a new session.
Inputs: id (required), project (required), directory. Returns: object
erinys_session_summaryErinys Session SummaryC
Save comprehensive end-of-session summary (Goal/Discoveries/Accomplished).
Inputs: content (required), project (required), session_id. Returns: object
erinys_statsErinys StatsC
Database statistics: observation count, project breakdown, health.
Inputs: project. Returns: object
erinys_supersedeErinys SupersedeC
Supersede an old observation with updated fact.
Inputs: old_id (required), reason (required), new_content (required). Returns: object
erinys_timelineErinys TimelineC
Query facts valid at a specific point in time.
Inputs: query (required), as_of. Returns: object
erinys_traverseErinys TraverseC
Traverse graph from a starting observation.
Inputs: start_id (required), max_depth, relation_filter. Returns: object
erinys_updateErinys UpdateB
Update an existing observation. Only provided fields are changed.
Inputs: id (required), type, scope, title, +3 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Several tools have overlapping memory-access purposes: erinys_recall vs erinys_context vs erinys_search, erinys_save vs erinys_batch_save, erinys_delete vs erinys_forget, and erinys_session_summary vs erinys_session_end. The descriptions clarify nuances, but an agent may still hesitate between near-duplicate operations.
All tools consistently use snake_case with the erinys_ prefix. However, the naming mixes verb-only forms (recall, export, link, prune), noun forms (context, stats, timeline, lineage), and compound forms (batch_save, conflict_check), so the pattern is mostly but not fully predictable.
With 29 tools, the surface is heavy for a memory server and exceeds the typical well-scoped range. Some operations could likely be consolidated or made optional groups, especially the near-duplicate save/read/delete/session variants.
The server covers observation CRUD, search, sessions, graph linking/traversal, temporal/provenance operations, export, backup, stats, and advanced maintenance such as dreaming and forgetting. Minor gaps exist, such as backup without restore/import and link creation without an explicit unlink operation.
Maintenance
Related MCP Connectors
Cloud-hosted MCP server for durable AI memory
Cloudflare Workers MCP server: agent-memory
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Graph-native persistent memory for AI agents — 33 MCP tools, zero-LLM writes.
Related MCP Servers
AlicenseNot gradedqualityAmaintenanceMCP server providing cognitive memory tools (remember, recall, think, etc.) for AI agents, enabling forgetting, consolidation, and contradiction detection.179Apache 2.0- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides AI agents with persistent, multi-layered memory inspired by the human brain, including consolidation, self-reflection, and generative replay.1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents persistent, forgetting memory with layered decay, semantic search via token overlap, and zero external dependencies.MIT
- AlicenseAqualityBmaintenanceAn MCP server providing long-term memory for AI agents with forgetting curves, consolidation, and graph-based retrieval.1014 npmMIT