inspeximus — AI 에이전트를 위한 정확성을 유지하는 장기 기억

단일 파일, 의존성 제로의 파이썬 에이전트 메모리와 Claude Code 및 Cursor용 MCP 서버. 사실이 수정되면 inspeximus는 새 값을 제공하고 이전 값이 다시 나타나는 것을 막습니다 — LLM 개입 없이 결정론적으로.

pip install inspeximus

중요한 30초

모든 메모리 라이브러리는 저장하고 검색할 수 있습니다. 아무도 답하지 않는 질문은 저장된 사실이 틀렸을 때 어떤 일이 일어나는가입니다.

from inspeximus import Inspeximus

m = Inspeximus("memory.json")

m.remember("The staging database is db-3.internal", key="staging-db")
m.remember("The staging database is db-7.internal", key="staging-db")   # a correction

m.recall("which staging database")[0]["text"]
# 'The staging database is db-7.internal'          <- the correction wins, every time

m.revert("staging-db")                              # and it is reversible
m.recall("which staging database")[0]["text"]
# 'The staging database is db-3.internal'

임베딩 드리프트도, "LLM이 보통 최신 것을 선택한다"도 없습니다. 이전 값은 키별로 폐기되며, 폐기는 감사, 되돌리기, 증명할 수 있는 기록입니다.

Related MCP server: NeverOnce

또 다른 메모리 라이브러리인 이유

다른 라이브러리들이 공개하지 않는 한 가지를 측정했기 때문입니다: 수정된 사실이 얼마나 자주 다시 나타나는지.

각 시스템은 자체 기본 구성, 동일한 작업, 동일한 30회 시행으로 실행되었습니다:

n = 시스템당 30. mem0은 2.0.11 (2026-07)에서 측정되었습니다; mem0은 현재 2.0.18이며 재실행하지 않았습니다 — 주장을 현재형으로 다시 진술하는 대신 버전을 명시했습니다. 전체 방법, 원시 배열 및 재실행 가능한 도구: RAMR · echo_resistance_backends_result.json

Graphiti 행을 올바르게 읽으십시오 — 에코 방어는 실패하지 않았습니다. 우리의 자체 원시 출력은 에코가 실행되기 전에 올바르게 추출된 26개의 수정 사항 중 echo_attributable_flips: 0을 기록합니다. Graphiti의 이중 시간 무효화는 그 모든 것을 유지했습니다. 위의 13.3%는 네 번의 에코 전 추출 누락입니다 — 수정 사항이 그래프에 들어가지 못했습니다 — 이는 이 표가 다루는 실패와 다른 종류의 실패입니다. 헤드라인이 아닌 메커니즘으로 설명하자면: 에코로 인한 부활에서 Graphiti는 쓰기 시간에 대체 링크를 기록함으로써 우리와 동일하게 **0%**를 기록합니다. 이것이 여기서의 실제 발견입니다: 이 시스템들을 구분하는 것은 누가 기록했는지가 아니라 링크가 기록되었는지 여부입니다.

마지막 행이 핵심입니다. 가드를 끄면 0점을 기록합니다 — 따라서 숫자는 메커니즘이지 벤치마크가 우리에게 유리하게 작용한 것이 아닙니다.

Claude Code에서 사용하기 (한 줄)

inspeximus install --ide claude     # also: cursor, windsurf, codex, cline

이것은 71개의 도구와 세 개의 훅을 가진 MCP 서버를 연결합니다. 다음 세션부터 에이전트는 이전 세션이 결정한 것을 알기 시작합니다 — CLAUDE.md 편집이나 재설명이 필요 없습니다:

• SessionStart는 여전히 유효한 결정을 주입합니다

• PostToolUse는 실제로 일어난 일을 파일별로 키에 매핑하여 캡처합니다

• PreToolUse는 작업이 실행되기 전에 해당 작업에 영향을 미치는 결정을 표면화합니다

제공되는 기능

일급 연산으로서의 수정. remember(key=...)는 해당 키의 이전 값을 폐기합니다. revert(key)는 복원합니다. history(key)는 체인을 보여줍니다. 모두 결정론적이며 감사 가능합니다.

증명 가능한 삭제. forget_subject()는 주제에 귀속될 수 있는 모든 메모리(계보를 통해 상속된 요약 포함)를 하드 삭제하고 서명된 빈 내용의 툼스톤을 남겨, 이후 감사에서 의도적으로 삭제된 것과 변조된 것을 구분할 수 있게 합니다.

저장뿐만 아니라 확인 가능한 출처. check_sources()는 각 기록의 출처를 다시 읽고 FRESH / DRIFTED / ORPHANED / UNCHECKABLE을 반환하며, 의도적으로 분리된 네 가지 적용 범위 숫자를 제공합니다 — 98.3% 채워지고 0.01% 다시 가져올 수 있는 source 필드는 보장이 아닌 스키마이기 때문입니다. (이 두 숫자는 우리의 것이며, 자체 프로덕션 저장소에서 측정되었습니다.)

현재 상태 적용 가능성. evaluate_applicability()는 "이 메모리가 사실인가"와는 다른 질문에 답합니다: 여기, 지금, 이 조치를 실행하는 데 사용될 수 있는가? 역사적 증거는 완벽하게 유효하지만 더 이상 권한이 부여되지 않을 수 있습니다 — 브랜치가 이동했거나, 정책이 변경되었거나, 테넌트가 다르거나, 기간이 만료되었습니다. 벤더 중립적인 CML 계약을 구현합니다; 두 개의 독립적인 구현이 고정된 픽스처에 동의합니다.

멀티 테넌트 격리. for_tenant("acme")는 하나의 공유 저장소에 대한 범위가 지정된 뷰를 제공하며, 테넌트가 서명된 메시지에 바인딩되어 기록이 테넌트 간에 이동되어도 검증될 수 없습니다.

의존성 제로. 단일 파일. 의미론적 검색은 선택 사항입니다(embed=your_model); 어휘 대체는 아무것도 필요로 하지 않습니다. MCP 서버, 암호화 및 프레임워크 어댑터는 모두 옵트인 추가 기능입니다.

호환성

langchain · langgraph-store · llamaindex · haystack · autogen · pydantic-ai · google-adk · memoryagentbench

13개 중 10개는 현재 업스트림에 대해 검증됨, 3개는 중단됨으로 기록됨 — crewai, langgraph-checkpointer 및 openai-agents는 목록에서 조용히 제거되지 않고 명명되었습니다. 개수는 클레임 감사에 의해 docs/integration_conformance.json에서 읽히므로 이 줄은 실행기가 마지막으로 측정한 것과 다를 수 없습니다.

성공만을 나열하는 "호환성" 목록은 로고 벽입니다. 이 목록은 어떤 어댑터가 구축하기 전에 중단될지 알려줍니다.

테스트 방법

2,600개 이상의 테스트와 돌연변이 게이트가 이를 믿는 이유입니다: 175개의 의도적으로 주입된 결함, 175개 제거, 0개 생존. 통과하는 테스트 스위트는 증거가 아닙니다; 모든 의도적인 중단을 잡아내는 스위트가 증거입니다.

이 페이지의 모든 숫자는 docs/CLAIMS.md에 등록되어 있으며, 이를 재계산하는 정확한 명령어가 있습니다. 하나가 여러분의 실행과 일치하지 않는다면, 그것이 우리가 원하는 버그 보고서입니다.

문서

대상 사용자

분 단위가 아닌 주 단위로 실행되는 에이전트를 구축 중인 사용자입니다. 에이전트는 무언가를 배우고, 그리고 그 무언가는 변경될 것입니다 — 설정 값, 정책, 사람의 선호도, 사실. 비용이 발생할 실패는 에이전트가 잊어버리는 것이 아닙니다. 에이전트가 이전 답변을 자신 있게 기억하는 것입니다.

이것이 이 라이브러리가 구축된 실패이며, 우리가 스스로를 벤치마킹하는 유일한 것입니다.

인용

버전 독립적인 DOI로 Zenodo에 보관됨 — 10.5281/zenodo.21708778. 기계 판독 가능 메타데이터는 CITATION.cff에 있으므로, GitHub의 "이 저장소 인용" 버튼이 BibTeX 및 APA를 직접 제공합니다.

MIT 라이선스. Agora에 의해 구축됨, 성공적인 복제 옆에 실패한 복제를 게시하는 자율 연구 조직.

mcp-name: io.github.DanceNitra/inspeximus