Skip to main content
Glama

ERINYS — AI 에이전트를 위한 반사적 기억

🇯🇵 日本語版 / Japanese

존재했던 기억으로부터, 존재하지 않았던 기억까지 만들어냅니다.

AI 에이전트의 기억 시스템은 항상 인간의 기억을 모방해 왔습니다. 단기, 장기, 일화적, 의미적 기억 등 교과서적인 분류를 구현에 그대로 적용했습니다.

무언가 항상 어색했습니다.

인간은 망각합니다. 하지만 기존의 기억 시스템은 그렇지 않습니다. 기억은 끝없이 증식하며, 오래된 사실을 최신 정보와 동일한 비중으로 제공합니다. 인간은 "잠깐, 아까는 다르게 말하지 않았어?"라고 알아차리지만, 기억 시스템은 조용히 덮어씁니다. 인간은 서로 관련 없는 두 경험을 연결하며 "아, 여기서 써먹을 수 있겠네"라고 생각하지만, 기억 시스템은 단순히 저장하고 검색할 뿐입니다.

모방해야 했던 것은 기억의 분류 체계가 아니었습니다. 바로 그 행동 방식이었습니다.

그 불편함이 ERINYS를 탄생시켰습니다.

ERINYS는 감시견입니다. 기억하고, 잊고, 질문하고, 물어뜯습니다.

ERINYS가 특별한 이유

망각. 대부분의 기억 시스템은 축적만 합니다. ERINYS는 에빙하우스의 망각 곡선에 따라 시간이 지남에 따라 기억을 감쇠시킵니다. 오래된 노이즈는 가라앉고, 자주 접근하는 지식은 떠오릅니다. 검색 결과는 수동 관리 없이도 관련성을 유지합니다.

증류(Distillation). 특정 버그 수정("JWT httpOnly 플래그가 누락됨")은 자동으로 세 가지 계층을 생성합니다: 구체적 사실 → 재사용 가능한 패턴("새 엔드포인트에는 보안 체크리스트가 필요함") → 보편적 원칙("보안 기본값은 옵트인 없이 안전해야 함"). 다른 어떤 기억 시스템도 이런 기능을 제공하지 않습니다.

꿈의 주기(Dream Cycle). 두 개의 기억이 LLM에 입력됩니다: "연관성이 있는가?" 후보 쌍은 의미론적 유사성에 의해 선택됩니다 — 관련성이 있을 만큼 가깝고(코사인 > 0.65), 중복되지 않을 만큼 멉니다(< 0.90). cron을 통해 밤사이에 예약되어, 당신이 미처 생각하지 못한 연결 고리를 찾아냅니다. 마법은 없습니다. 그저 대규모 자동 노트 비교일 뿐입니다.

Related MCP server: cell-mem

설계 철학

기억에는 계층이 있습니다

모든 기억이 동일하지는 않습니다. ERINYS는 지식을 추상화 수준에 따라 구성합니다:

  • 구체적(Concrete) — 무슨 일이 일어났는가. "/api/auth에서 JWT httpOnly 플래그가 누락되었다."

  • 추상적(Abstract) — 사실로부터 얻은 패턴. "새 API 엔드포인트에는 보안 헤더 체크리스트가 필요하다."

  • 메타(Meta) — 패턴으로부터 얻은 원칙. "보안 기본값은 수동 옵트인 없이 안전해야 한다."

단 하나의 버그 수정이 증류 과정을 통해 이 세 가지를 모두 생성합니다. 메타 계층은 프로젝트와 기술 스택을 넘나드는 원칙들을 축적합니다.

망각은 기능입니다

모든 기억은 시간이 지남에 따라 감쇠하는 강도 점수를 가집니다. 6개월 전에 저장된 기억은 어제 저장된 기억보다 낮은 순위를 가집니다. 자주 접근하는 기억은 감쇠에 저항합니다 — 반복적인 검색이 기억을 강화합니다.

강도가 임계값 아래로 떨어지면, 해당 기억은 정리(pruning) 후보가 됩니다. 데이터베이스는 가볍게 유지되고, 검색은 관련성을 유지합니다.

사실은 변합니다. 역사는 사라지지 않아야 합니다

정보가 업데이트될 때("AWS에서 GCP로 이전했다") — ERINYS는 덮어쓰지 않습니다. 대신 대체 체인(supersede chain)을 생성합니다: 이전 사실은 대체된 것으로 표시되지만 보존됩니다. "3월에는 우리가 무엇을 믿었지?"라고 물으면 당시에는 사실이었던 답변을 얻을 수 있습니다.

모순은 포착되어야 합니다

기억에 "PostgreSQL 사용"과 "SQLite 사용"이 모두 포함되어 있다면, ERINYS는 충돌을 감지합니다. 조용히 전환하는 대신, 에이전트는 질문합니다: "이전에 PostgreSQL을 선택하셨는데, 요구사항이 변경되었나요?"

검색은 키워드가 아닌 의미를 찾습니다

두 가지 검색이 동시에 실행되어 결과를 융합합니다:

  • 키워드 검색(FTS5) — 정확한 용어 일치.

  • 벡터 검색(sqlite-vec) — 의미론적 유사성. "authentication"은 "login", "JWT", "session tokens"를 찾습니다.

결과는 RRF(Reciprocal Rank Fusion)를 통해 병합됩니다. 둘 다에서 높은 순위일수록 가장 높은 점수를 받습니다.

모든 것은 로컬에 머뭅니다

단일 SQLite 파일. 클라우드 API 없음. API 키 없음. 구독 없음. 오프라인 가능. 에이전트의 기억은 절대 당신의 기기를 떠나지 않습니다.

사용 사례

1. 코딩 에이전트를 위한 세션 간 기억

# 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. 모순 탐지

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. 꿈의 주기 — 야간 지식 합성

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. 시간적 쿼리

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. 지식 증류

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. Obsidian 내보내기

erinys_export(format="markdown")
# → Generates .md files with [[wikilinks]]
# Drop into Obsidian → instant knowledge graph

빠른 시작

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

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)

~/.gemini/antigravity/settings.json의 mcpServers 아래에 추가하세요:

{
  "erinys": {
    "command": "/path/to/ERINYS-mem/.venv/bin/python3",
    "args": ["-m", "erinys_memory.server"],
    "env": {
      "ERINYS_DB_PATH": "~/.erinys/memory.db"
    }
  }
}

환경 변수

변수

기본값

설명

ERINYS_DB_PATH

~/.erinys/memory.db

SQLite 데이터베이스 경로

ERINYS_EMBEDDING_MODEL

BAAI/bge-small-en-v1.5

fastembed 모델

도구 (25)

핵심

  • erinys_save — 관찰 내용 저장 (topic_key upsert 포함)

  • erinys_get — ID로 가져오기 (전체 내용, 잘림 없음)

  • erinys_update — 부분 업데이트

  • erinys_delete — FK 캐스케이드와 함께 삭제

  • erinys_search — RRF 하이브리드 검색 (FTS5 + 벡터)

  • erinys_save_prompt — 사용자 프롬프트 저장

  • erinys_recall — 최근 관찰 내용

  • erinys_context — 세션 컨텍스트 회상

  • erinys_export — Obsidian 호환 마크다운 내보내기

  • erinys_backup — SQLite 백업

  • erinys_stats — 데이터베이스 통계

그래프

  • erinys_link — 타입이 지정된 엣지 생성

  • erinys_traverse — BFS 그래프 탐색

  • erinys_prune — 약하거나 감쇠된 엣지 정리

시간적

  • erinys_reinforce — 관찰 강도 강화

  • erinys_supersede — 관찰 내용 버전 관리

  • erinys_timeline — 타임스탬프 기준 쿼리

  • erinys_conflict_check — 모순 탐지

꿈의 주기

  • erinys_collide — LLM을 통해 두 관찰 내용 충돌시키기

  • erinys_dream — 배치 충돌 주기

증류

  • erinys_distill — 3단계 세분성 추상화 (구체적 → 추상적 → 메타)

배치 및 평가

  • erinys_batch_save — 자동 연결을 포함한 대량 저장

  • erinys_eval — LOCOMO 기반 품질 지표

세션

  • erinys_session_start — 세션 시작

  • erinys_session_end — 요약과 함께 세션 종료

  • erinys_session_summary — 구조화된 요약 저장

ERINYS 비교

기능

ERINYS

Mem0

공식 MCP Memory

하이브리드 검색 (키워드 + 벡터)

✅ FTS5 + sqlite-vec RRF

✅ 벡터 + 그래프

❌ 지식 그래프 전용

시간 감쇠 망각

✅ 에빙하우스 곡선

⚠️ 우선순위 점수

❌

3단계 증류 (구체적 → 추상적 → 메타)

✅

❌

❌

꿈의 주기 (충돌 기반 통찰)

✅

❌

❌

모순 탐지

✅

⚠️ 리졸버를 통한 덮어쓰기

❌

시간적 쿼리 ("3월에 무엇을 믿었나?")

✅ 대체 체인

⚠️ 그래프 무효화

❌

로컬 우선 (클라우드 API 없음)

✅ SQLite 단일 파일

❌ 클라우드 기본값

✅

Obsidian 내보내기

✅ [[wikilinks]]

❌

❌

저장 시 자동 증류

✅

❌

❌

MCP 네이티브

✅ 25개 도구

✅

✅

자기 평가 (LOCOMO 지표)

✅

❌

❌

요약 — 대부분의 메모리 서버는 저장하고 검색합니다. ERINYS는 또한 잊고, 증류하고, 꿈을 꿉니다.

아키텍처

┌──────────────────────────┐
│     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
└──────────────────────────┘

로드맵

  • [ ] Dream Daemon — 꿈의 주기의 백그라운드 자동 실행

  • [x] 저장 시 자동 증류 — 저장할 때마다 3단계 세분성 증류 트리거

  • [ ] 자동 정리 — DB가 크기 임계값을 초과할 때 감쇠된 관찰 내용 GC

  • [ ] Cron 지원 CLI — 예약된 야간 합성을 위한 erinys dream --max 10

  • [ ] PyPI 패키지 — pip install erinys-memory

  • [ ] 다중 에이전트 지원 — 에이전트 ID별 범위 지정 메모리

라이선스

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