Argon Memory

실제 작업을 수행하는 에이전트를 위한 영구 프로젝트 메모리

문서, 에이전트 출력, 결정, 검증된 대화를 지속적이고 증거 기반의 프로젝트 메모리로 전환하는 오픈소스 MCP 지식 시스템입니다.

中文 · 아키텍처 · MCP 도구 · 벤치마크 · 보안

대부분의 에이전트 메모리 시스템은 채팅 조각을 저장합니다. Argon Memory는 프로젝트를 유지합니다.

연결된 모든 에이전트에게 동일한 간결한 프로젝트 맵을 제공하고, 필요할 때만 정확한 증거를 검색할 수 있게 하며, 작업 후 지속 가능한 출력물과 정제된 지식을 저장하여 루프를 닫습니다. 사실은 서로를 조용히 덮어쓰지 않습니다. 출처, 개정 이력, 검증 상태, 미해결 충돌은 계속 표시됩니다.

Argon Memory를 선택하는 이유

• 프로젝트 형태의 메모리 — 하나의 안정적인 메인 파일, 유지 관리되는 도메인 섹션, 지식 그래프, 연결된 Artifact.

• 토큰 효율적인 컨텍스트 — 먼저 작은 프로젝트 맵을 로드하고, 작업에 필요할 때만 섹션과 증거 발췌문을 검색합니다.

• 신뢰보다 증거 우선 — 승인된 메모리는 소스 레코드에 연결되며, 검증되지 않은 후보는 사실이 되는 대신 격리됩니다.

• 지속 가능한 에이전트 마무리 — 작업 항목, 생성된 리소스, 결정, 교훈, 미해결 질문이 채팅 세션을 넘어 유지됩니다.

• 충돌 인지 설계 — 경쟁 주장은 공개되고 승인된 인간 해결자에게 라우팅됩니다. 모델이 조용히 승자를 선택할 수 없습니다.

• 추가 전용 히스토리 — 불변 개정 매니페스트, SHA-256 지문, 감사 이벤트, 파괴적 삭제 대신 대체(supersession).

• MCP 네이티브 — Codex, Claude Code, Qoder, Hermes, Cursor 또는 모든 Streamable HTTP MCP 클라이언트와 호환됩니다.

• 모델 중립적 — 쿼리 경로는 LLM을 요구하지 않습니다. 별도의 선택적 유지 관리 워커는 사용자가 선택한 모델과 공급자를 사용할 수 있습니다.

Related MCP server: lore

개념 모델

flowchart LR
  A["Agent starts a task"] --> B["Main project file"]
  B --> C["Maintained section"]
  C --> D["Linked Artifact evidence"]
  C --> E["Accepted memory"]
  D --> F["Precise answer or project work"]
  E --> F
  F --> G["Work closeout"]
  G --> H["Outputs + distilled knowledge"]
  H --> I["Validation and conflict routing"]
  I --> B

레이어는 서로 다른 역할을 합니다:

빠른 시작

요구 사항: Node.js 22+; Python 3.10+는 선택적 MinerU 어댑터를 사용할 때만 필요합니다.

git clone https://github.com/Tangtaizong-BUAA/ArgonMemory.git
cd ArgonMemory
npm install
npm run build

export ARGON_MEMORY_KB_ROOT="$PWD/data"
export ARGON_MEMORY_MCP_PROFILE="project-ops"
export ARGON_MEMORY_ALLOW_UNAUTHENTICATED="true" # local bootstrap only
npm start

MCP 엔드포인트는 http://127.0.0.1:8793/mcp이며, 상태 확인은 http://127.0.0.1:8793/health에서 가능합니다.

kb_bootstrap_project로 첫 번째 프로젝트를 부트스트랩합니다:

{
  "project_id": "project:my-product",
  "title": "My Product",
  "mission": "Maintain a trustworthy, durable operating memory for this product."
}

부트스트랩 후에는 project-contribute 프로필로 일반 에이전트를 실행하고 번들된 argon-memory Skill을 설치합니다.

MCP 클라이언트 연결

{
  "mcpServers": {
    "argon_memory": {
      "url": "http://127.0.0.1:8793/mcp",
      "headers": {
        "Authorization": "Bearer ${ARGON_MEMORY_TOKEN}"
      }
    }
  }
}

로컬 단일 사용자 실험의 경우 ARGON_MEMORY_ALLOW_UNAUTHENTICATED=true일 때만 헤더를 생략합니다. 인증되지 않은 contribute 또는 ops 프로필을 네트워크에 노출하지 마십시오.

에이전트 워크플로우

kb_sync_skill → kb_brief → kb_graph_context → kb_search as needed
              → kb_start_work → publish/capture → kb_finish_work

1. kb_brief가 완전한 간결한 프로젝트 맵을 로드합니다.

2. kb_graph_context가 유지 관리되는 섹션 하나와 연결된 증거를 엽니다.

3. kb_search가 정확한 사실, 이름, 날짜, 버전, 인용문, Artifact 발췌문을 검색합니다.

4. kb_start_work가 실제 작업이 시작되기 전에 지속 가능한 작업 정체성을 생성합니다.

5. kb_publish_resource가 유용한 출력물을 저장하고, kb_capture_context가 정제된 메모리 후보를 제출합니다.

6. kb_finish_work가 결과, 증거, 미해결 항목, 멱등 결과 해시를 기록합니다.

이러한 분리는 두 가지 일반적인 실패를 방지합니다: 모든 프롬프트에 전체 아카이브를 넘치는 것과 짧은 요약이 충분한 증거라고 가장하는 것입니다.

권한 프로필

주체 토큰은 ARGON_MEMORY_MCP_PRINCIPALS_JSON에 SHA-256 해시로 저장됩니다. 해결자 접근에는 추가로 project-owner 또는 designated-resolver 역할이 필요합니다. 공유 토큰은 어떤 인간이 말했는지 증명하지 않습니다.

표준 저장소

Argon Memory는 의도적으로 인간이 검사할 수 있는 Markdown과 YAML frontmatter를 표준 진실로 유지합니다. 검색 인덱스와 그래프 뷰는 파생되며 재구축 가능합니다.

data/
├── registry/                 # projects, sections, work, Artifacts, conflicts
├── memory/                   # structured memory records
├── events/                   # durable activity records
├── resources/                # immutable uploaded bytes
├── normalized/               # parser-derived Markdown and media links
├── audit/events.jsonl        # append-only audit stream
├── maintenance/queue.sqlite  # bounded maintenance ChangePackets
└── knowledge/
    ├── revisions/            # immutable canonical snapshots
    ├── indexes/              # rebuildable derived indexes
    └── current-revision.json # atomic pointer to one consistent snapshot

이 저장소에는 프로젝트 데이터가 포함되지 않습니다. data/ 트리는 런타임에 생성되며 Git에서 무시됩니다.

Artifact 정규화

텍스트, Markdown, CSV, JSON, YAML은 즉시 검색 가능해집니다. 바이너리 문서는 정규화될 때까지 불변 Artifact로 유지됩니다.

MinerU Cloud는 선택적 어댑터입니다:

python3 -m pip install mineru-open-sdk
export MINERU_API_KEY="..."

그런 다음 ops 주체가 소스 루트를 등록하고, 인벤토리를 수집하고, kb_parse_artifact를 호출할 수 있습니다. API 이그레스는 감사 로그에 기록됩니다. Argon Memory는 MinerU의 저장소나 모델 레이어에 결합되지 않습니다. 다른 정규화 도구도 동일한 정규화된 Markdown 계약을 작성할 수 있습니다.

의도적으로 포함되지 않은 것

• 채팅 UI 또는 호스팅된 온라인 에이전트 없음.

• 명령 실행기, 컨테이너 워크스페이스, 원격 실행 플레인 없음.

• 프로젝트 문서, 사용자 파일, 프로덕션 데이터베이스, 자격 증명, 배포 비밀 없음.

• 연결된 클라이언트를 대신해 답변하는 모델 없음.

• 게시된 패키지에 테스트 픽스처 또는 테스트 코퍼스 없음.

Argon Memory는 메모리 레이어입니다. 로컬 또는 호스팅된 에이전트가 추론 및 실행 레이어로 남습니다.

상태

0.1.1은 프로덕션 프로젝트 메모리 시스템에서 추출된 현재 독립형 Argon 릴리스입니다. 저장소 계약, MCP 표면, 출처 규칙, 충돌 경계는 오늘 사용할 수 있습니다. 고규모 벡터 백엔드와 추가 정규화 어댑터는 향후 작업으로 남아 있습니다.

공개 벤치마크

Argon Memory는 공식 LongMemEval-V2 에이전트 메모리 벤치마크용 MCP 네이티브 어댑터를 포함합니다. 답변 품질과 쿼리 지연 시간을 측정하면서 다섯 가지 메모리 능력에 걸쳐 장기 웹 및 엔터프라이즈 궤적을 평가합니다. 합성 케이스는 스모크 게이트로만 사용되며 벤치마크 점수로 보고되지 않습니다. 벤치마크, 보고 정책, 첫 번째 공개 검색 진단을 참조하십시오.

위 비교는 공식 릴리스된 RAG, AgentRunbook-R, Codex, AgentRunbook-C 정확도/지연 시간 포인트를 재현하고 AgentRunbook-C V2 연구 업데이트를 별도로 표시합니다. Argon의 공식 답변 정확도와 LAFS는 아직 보류 중입니다. 아래 진단은 검색 전용이며 답변 정확도로 표시되지 않습니다.

계보 및 라이선스

Argon Memory는 MIT 라이선스 MinerU Document Explorer를 기반으로 구축된 프로젝트 메모리 작업에서 파생되었습니다. Argon Memory 0.1.1 이상은 명시적 특허 허여를 포함하여 Apache License 2.0에 따라 릴리스됩니다. 업스트림 귀속 및 원본 MIT 고지는 NOTICE 및 THIRD_PARTY_NOTICES.md에 보존됩니다.

기여자

Argon Memory는 Tangtaizong-BUAA가 창작하고 이끌며, OpenAI Codex가 AI 엔지니어링 협력자로 인정됩니다. 역할 및 귀속 경계는 CONTRIBUTORS.md에 문서화되어 있습니다.

기여를 환영합니다. 풀 리퀘스트를 열거나 취약점을 보고하기 전에 CONTRIBUTING.md 및 SECURITY.md를 읽어 주십시오.