matrixorigin/memoria

Secure memory management for AI Agents • Ensures data integrity • Reduces hallucinations • Maintains consistent long-term context

Memoria란 무엇인가요?

Memoria는 AI 에이전트의 내부 지식에 Git 스타일의 버전 관리를 도입하는 지속 가능한 메모리 계층입니다. 에이전트의 '메모리'(사실, 선호사항, 절차적 단계 등)에 대한 모든 변경은 스냅샷으로 저장되며, 브랜치화, 머지, 시점 기반 롤백이 가능하며, 하이브리드 벡터+전체 텍스트 엔진을 통해 검색할 수 있습니다. 시스템은 MatrixOne의 복사-온-라이트 데이터베이스 기반으로 구축되어, 제로-복사 브랜치 및 불변 저장을 제공합니다.

핵심 기능

기능	Memoria의 구현 방식
Git 수준의 버전 관리	메모리 변경 사항에 대해 즉시 스냅샷, 브랜치, 머지, 시점 기반 롤백을 제공합니다.
의미 기반 검색	하이브리드 벡터 + 전체 텍스트 검색을 통해 키워드가 아닌 의미 기반으로 메모리를 찾을 수 있습니다.
자기 주도성	모순되거나 신뢰도가 낮은 메모리를 자동 감지하고 격리하며, 감사 로그를 남깁니다.
개인정보 보호	로컬 임베딩 모델을 실행할 수 있어 데이터가 기계 외부로 나가지 않습니다.
대화 간 지속성	메모리(사실, 선호사항, 목표)가 별도의 세션 간에 유지됩니다.
완전한 감사 로그	모든 변경 사항에 기원 정보가 기록되며, 나중에 검토할 수 있습니다.

누구에게 적합한가요?

Memoria는 모든 MCP 호환 AI 에이전트와 함께 사용할 수 있습니다. README에는 다음과 같은 미리 준비된 통합이 포함되어 있습니다:

Kiro
Cursor
Claude Code
OpenAI Codex
Gemini CLI
OpenClaw (플러그인을 통해)

사용자 정의 에이전트에서 REST API를 직접 호출할 수도 있습니다.

시작하기

클라우드(권장) – thememoria.ai에서 계정을 만들고 CLI를 설치한 후, Remote 모드에서 memoria init -i를 실행하고 토큰을 제공합니다.
자체 호스팅 – 제공된 Docker Compose를 사용해 MatrixOne 인스턴스와 Memoria API를 시작한 후, CLI를 Embedded 모드로 실행합니다.
OpenClaw 플러그인 – 플러그인을 설치하고 클라우드 또는 자체 호스팅 엔드포인트를 구성합니다.

바이너리는 GitHub 릴리스 페이지에서도 사용 가능합니다.

에이전트가 어떻게 사용하는가

Memoria는 에이전트가 호출할 수 있는 MCP 도구를 제공합니다. 예를 들어:

memory_store – 새로운 사실이나 컨텍스트를 추가합니다.
memory_retrieve / memory_search – 대화 시작 시 또는 필요 시 관련 메모리를 가져옵니다.
memory_branch, memory_checkout, memory_merge – 별도의 브랜치에서 실험하고, 좋은 결과를 나중에 머지합니다.
memory_snapshot, memory_rollback – 이름이 지정된 체크포인트를 만들고 필요 시 되돌릴 수 있습니다.
거버넌스 도구(memory_governance, memory_consolidate)는 모순을 자동으로 정리합니다.

스티어링 규칙(memory, session‑lifecycle, memory‑hygiene)은 에이전트가 언제 이러한 도구를 호출해야 하는지 지시합니다.

아키텍처 개요

원격 모드 – 에이전트는 Memoria CLI(MCP 브리지)와 통신하며, HTTP를 통해 Memoria 클라우드 서비스로 요청을 전달합니다.
임베디드 모드 – CLI는 로컬 MCP 서버를 실행하여 MatrixOne 데이터베이스와 직접 통신하며, 벡터 저장, 전체 텍스트 인덱싱, 데이터용 Git 레이어를 처리합니다.

누구에게 유용한가요?

여러 상호작용에 걸쳐 신뢰성 있고 감사 가능한 상태가 필요한 자율 에이전트 개발자.
검색된 컨텍스트를 버전 관리하고 되돌릴 수 있는 RAG 파이프라인.
자기 주도 메모리 시스템이나 데이터 중심 AI를 탐구하는 연구자.
엄격한 감사 로그와 에이전트 지식 기반의 잘못된 업데이트를 되돌릴 수 있는 능력이 필요한 기업.

라이선스 및 커뮤니티

Memoria는 Apache‑2.0 라이선스 하에 배포됩니다. 프로젝트는 오픈소스이며, CI 파이프라인을 제공하며, GitHub의 일반적인 워크플로우를 통해 기여를 환영합니다.

TL;DR – Memoria는 AI 에이전트를 위한 Git 스타일의 버전 관리 메모리 저장소로, 스냅샷, 브랜치, 의미 기반 검색, 자동 일관성 검사를 제공하며, 클라우드 또는 자체 호스팅 배포로 사용 가능합니다.