메모리, 에이전트, 에셋 — 하나의 그래프.
Kumiho는 에이전트 시대를 위한 메모리·출처 기반입니다. 모든 사실에 형식적 신념 수정과 출처가 붙는 버전 관리 타입 그래프 — 그 위에서 AI Memory와 Revka가 동작하고, 같은 엔진이 프로덕션 파이프라인의 크리에이티브 에셋을 버전 관리합니다.
curl -fsSL https://kumiho.io/install | sh무료 · 단일 사용자 · 전부 내 컴퓨터에서 실행
$ kumiho get kref://CognitiveMemory/preferences/ui-theme.preference r1 dark mode r2 Dracula theme r3 SUPERSEDES r2 → Solarized
AI Memory
임베딩 캐시가 아닌, 인지 메모리 코어.
모든 기록은 출처 그래프 안의 타입·버전 노드가 됩니다. 세상이 바뀌면 메모리는 모순을 쌓는 대신 형식적으로 수정됩니다.
- 증명된 신념 수정
- AGM 준수 revise/contract/expand — 실제 엔진 기준 준수 시나리오 49/49 통과. 리포트는 공개되어 있습니다.
- 쓰기 시점 온톨로지
- 사실·결정·엔티티·관계를 회수 시점에 추측하지 않고, 메모리를 쓰는 순간 추출합니다.
- 두 가지 리플렉스, 모든 에이전트
- 응답 전 engage, 응답 후 reflect — MCP 서버 하나로 Claude Code, Codex, 자체 스택까지 연결됩니다.
- Dream State
- 백그라운드 비동기 통합이 메모리를 검토·연결·정리합니다. 서킷 브레이커가 있어 히스토리를 조용히 파괴하지 않습니다.
- kref:// 주소 체계
- 모든 메모리 리비전에 안정적인 URI가 붙습니다. 인용하고, 비교하고, 추적하고, 되돌릴 수 있습니다.
- 하이브리드 회수
- 풀텍스트, 그래프 탐색, 벡터 유사도가 하나의 랭킹 회수로 결합됩니다. 유사도는 방법일 뿐, 모델이 아닙니다.
메모리가 없을 때
세션 1 "다크 모드를 선호해" 세션 2 다시 물어봄 세션 5 잘못된 선호를 회수
Kumiho와 함께
kref://CognitiveMemory/preferences/ui-theme.preference r1 다크 모드 r2 Dracula 테마 r3 SUPERSEDES r2 → Solarized
LoCoMo-Plus 93.3% · AGM 준수 49/49 — 모든 숫자는 직접 재실행할 수 있는 공개 아티팩트로 연결됩니다.
벤치마크 하니스 + 결과pip install kumiho-memoryRevka
메모리 네이티브 AI 에이전트 런타임.
변조가 드러나는 Merkle 감사 추적을 갖춘 에이전트 워크플로 — 한 명이 운영할 만큼 가볍고, 보안 리뷰를 통과할 만큼 구조적입니다. 모든 실행이 같은 그래프에 기억되어, 에이전트가 Kumiho가 아는 모든 것을 물려받습니다.
이미 쓰고 있는 CLI를 그대로 구동
- Claude Code
- Codex
- Antigravity
- Cursor
- OpenCode
동작 방식
파일과 대화는 지금 있는 곳에 그대로 둡니다. Kumiho는 구조를 기억합니다 — 무엇을 배웠고, 결정했고, 바꿨는지. 그리고 무엇이 무엇에 의존하는지.
사용자 스토리지
로컬 / NAS / S3 / 에이전트 디스크
파일과 대화 아티팩트는 이동하지 않습니다.
클라이언트
MCP / 플러그인 / SDK / REST
리비전과 메모리 이벤트를 등록합니다.
Kumiho 그래프
Neo4j + Redis
타입 노드, 출처 엣지, 워킹 메모리.
조회 & 실행
회수 / 감사 / 이벤트
탐색하고, 추적하고, 자동화하고, 기억합니다.
기반 인프라: 멀티테넌트 격리 · 데이터 레지던시 · 실시간 이벤트 · Dream State 서킷 브레이커 · 불변 감사 추적 · 특허 출원 중 아키텍처
기반: 크리에이티브 작업을 위한 버전 관리.
Kumiho는 AI 메모리 데모로 시작하지 않았습니다. 그 아래 엔진은 히스토리를 잃으면 실제 비용이 발생하는 크리에이티브 파이프라인을 위해 만들어졌습니다 — 모든 렌더, 모델, 파일에 불변 리비전, 타입 의존성, 계보가 붙습니다. 에이전트 메모리는 그 엄밀함을 물려받습니다.
실제 워크플로
- 프롬프트·모델·시드를 캡처하며 AI 변형 200개 생성.
- 메타데이터와 계보로 비교·필터링.
- 선택 후 불변 리비전으로 퍼블리시.
- 언제든 출처 추적.

파일명 혼돈에서 주소화된 히스토리로
Before project_final/hero_v3_approved_v2.png
After kref://project/characters/hero.image
리비전 5개 · 계보 · 메타데이터 · 퍼블리시 상태60초 안에 확인하기
등록 → 수정 → 연결 → 회수
시작하는 방법
작업 방식에 맞는 진입점을 고르세요. 어디서 시작하든 같은 그래프에 기록됩니다.
- connect
MCP
MCP 호환 에이전트에 단일 통합 경로로 영속 메모리를 제공합니다.
- build
Python SDK
리비전 히스토리와 메모리 프리미티브를 자체 제품에 내장하세요.
- integrate
REST API
아이템, 리비전, 엣지, 검색 파이프라인에 직접 HTTP로 접근합니다.
- create
ComfyUI
모든 생성물을 버전 관리 — 프롬프트, 모델, 시드, 계보까지 캡처합니다.
- automate
n8n
에셋이나 메모리 상태가 바뀌면 다운스트림 작업을 트리거합니다.
자주 묻는 질문
스토리지를 마이그레이션해야 하나요?
아닙니다. 파일과 대화 아티팩트는 원래 위치에 그대로 둡니다. Kumiho는 구조 — 리비전, 관계, 출처 — 와 포인터를 저장합니다.
벡터 데이터베이스와 무엇이 다른가요?
Kumiho는 출처와 의존성 엣지를 가진 버전화된 타입 노드를 저장하고, 사실이 바뀌면 신념을 형식적으로 수정합니다. 벡터 유사도는 회수 방법 중 하나일 뿐, 메모리 모델이 아닙니다.
대화 데이터가 내 컴퓨터 밖으로 나가나요?
커뮤니티 에디션에서는 나가지 않습니다. 서버는 루프백에만 바인딩되고 모든 것이 로컬 Neo4j에 저장됩니다. 전체 대화는 아티팩트로 로컬에 유지할 수 있습니다.
LLM 제공자를 바꿀 수 있나요?
네. 메모리는 모델이 아니라 그래프에 저장됩니다 — 히스토리, 출처, 회수가 제공자와 모델 변경을 그대로 넘어갑니다.
Kumiho는 오픈소스인가요?
SDK와 벤치마크 하니스는 GitHub에 공개되어 있습니다 — 직접 실행할 수 있는 AGM 준수 스위트를 포함해서요. 커뮤니티 에디션 서버는 EULA 기반 무료 바이너리입니다.
Kumiho를 무료로 사용할 수 있나요?
Cloud Memory는 월 $7에 1인, CognitiveMemory 프로젝트 전용, 2,000 그래프 노드를 제공합니다. 로컬 단일 사용자용 Community Edition은 무료이며 데이터 한도가 없습니다.
폴더 하나, MCP 연결 하나로 시작하세요.
커뮤니티 에디션은 무료이고 전부 내 컴퓨터에서 실행됩니다. 클라우드는 원할 때 — 원한다면 — 선택하세요.
curl -fsSL https://kumiho.io/install | sh무료 · 단일 사용자 · 전부 내 컴퓨터에서 실행
