Skip to main content
Glama

ERINYS — Memoria reflexiva para agentes de IA

🇯🇵 日本語版 / Japanese

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 score

2. 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 graph

Inicio 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/ -v

Configuració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

ERINYS_DB_PATH

~/.erinys/memory.db

Ruta de la base de datos SQLite

ERINYS_EMBEDDING_MODEL

BAAI/bge-small-en-v1.5

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 parcial

  • erinys_delete — Eliminar con cascada FK

  • erinys_search — Búsqueda híbrida RRF (FTS5 + vector)

  • erinys_save_prompt — Guardar prompt del usuario

  • erinys_recall — Observaciones recientes

  • erinys_context — Recuperación de contexto de sesión

  • erinys_export — Exportación markdown compatible con Obsidian

  • erinys_backup — Copia de seguridad de SQLite

  • erinys_stats — Estadísticas de la base de datos

Grafo

  • erinys_link — Crear borde tipado

  • erinys_traverse — Recorrido de grafo BFS

  • erinys_prune — Podar bordes débiles/degradados

Temporal

  • erinys_reinforce — Aumentar la fuerza de la observación

  • erinys_supersede — Versionar una observación

  • erinys_timeline — Consultar según marca de tiempo

  • erinys_conflict_check — Detectar contradicciones

Ciclo de ensueño

  • erinys_collide — Colisionar dos observaciones mediante LLM

  • erinys_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ático

  • erinys_eval — Métricas de calidad inspiradas en LOCOMO

Sesión

  • erinys_session_start — Iniciar sesión

  • erinys_session_end — Finalizar sesión con resumen

  • erinys_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 10 para 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 tools
erinys_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_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_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

    C2.7/5.0

    Scored across 29 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers