Show HN 'YourMemory' 공개… 에빙하우스 망각곡선 적용한 AI 에이전트 메모리, LoCoMo 벤치 59% 리콜로 Zep Cloud 2배

사치트 미슈라(Sachit Misra)가 'YourMemory'라는 AI 에이전트용 영속 메모리 레이어를 Show HN에 공개했다. 매 세션마다 AI 어시스턴트가 사용자 선호와 기술 스택을 처음부터 다시 학습하는 문제를 해결하기 위해, 인간 기억의 작동 방식처럼 중요한 정보는 유지하고 잊혀진 정보는 자연 감쇠하며 오래된 사실은 자동 교체되는 구조로 설계됐다.

Snap Research의 LoCoMo 데이터셋(LoCoMo-10, 10건의 멀티 세션 대화·1,534개 QA 페어)에서 YourMemory는 BM25·벡터·그래프·감쇠 조합으로 Recall@5 59%(95% 신뢰구간 56~61%)를 기록했다. 동일 벤치마크에서 Zep Cloud의 28%(95% CI 26~30%)와 비교해 약 2배 높은 리콜이다. 전체 방법론과 샘플별 결과는 BENCHMARKS.md에 게시됐다.

설치는 'pip install yourmemory'와 'yourmemory-setup' 두 명령으로 끝나며 도커·외부 서비스 없이 동작한다. 'yourmemory-setup'은 spaCy 언어 모델을 내려받고 ~/.yourmemory/memories.duckdb 위치에 로컬 데이터베이스를 초기화한다. 파이썬 3.11~3.14를 지원한다.

메모리 강도(strength)는 시간에 따라 지수적으로 감쇠한다. 적용 공식은 effective_λ = base_λ × (1 − importance × 0.8), strength = importance × e^(−effective_λ × days) × (1 + recall_count × 0.2)이며, 자주 호출된 메모리일수록 감쇠가 둔화된다. 강도 0.05 미만 메모리는 24시간 주기로 자동 정리된다. 카테고리별 미호출 시 평균 잔존 기간은 strategy 약 38일, fact 약 24일, assumption 약 19일, failure 약 11일이다.

검색은 두 단계로 작동한다. 1단계는 벡터 검색으로 코사인 유사도 기반 top-k를 반환하고, 2단계는 1단계 결과를 시드로 한 그래프 BFS 확장이다. 어휘는 다르지만 의미상 연결된 메모리(코사인 유사도 0.4 이상의 시맨틱 엣지)를 추가로 노출한다. 또한 그래프 이웃 중 임계값 이상인 메모리가 있으면 감쇠 메모리를 보존하는 체인 인식 프루닝(chain-aware pruning)을 적용한다.

도구는 세 개다. recall_memory(query)는 작업 시작 시 호출돼 유사도×강도로 메모리를 정렬해 반환하고, store_memory(content, importance)는 학습 내용을 임베딩·저장하며, update_memory(id, new_content)는 갱신 시 재임베딩·교체한다. 샘플 CLAUDE.md가 함께 제공돼 Claude는 'recall→store→update' 워크플로를 작업마다 자동 수행한다.

스택은 기본 DuckDB(768차원 벡터, native 코사인 유사도)와 NetworkX(~/.yourmemory/graph.pkl)로 구성되며, sentence-transformers(all-mpnet-base-v2)로 로컬 임베딩, spaCy로 중복 제거·SVO 트리플 추출, APScheduler로 24시간 감쇠 잡을 처리한다. 팀·대규모 데이터셋용으로 PostgreSQL+pgvector, 그래프 백엔드용으로 Neo4j 옵션을 제공한다.

다중 에이전트가 같은 YourMemory 인스턴스를 공유할 수 있도록 API 키 기반 권한 분리도 마련됐다. register_agent로 agent_id별 can_read·can_write를 'shared'·'private' 단위로 설정하면 'ym_xxxx' 키가 한 번만 노출되고, MCP 호출 시 api_key·visibility를 함께 전달해 권한을 검증한다. 표준 stdio MCP 서버이므로 Claude Code, Claude Desktop, Cline, Cursor, OpenCode, Windsurf, Continue, Zed 등 MCP 호환 클라이언트와 결합된다.

라이선스는 CC-BY-NC-4.0으로 개인·교육·학술 연구·오픈소스 프로젝트 사용은 무료이고 상업 사용은 별도 서면 계약이 필요하다. 상업 라이선스 문의 메일은 mishrasachit1@gmail.com이다.