메모리, 에이전트, 에셋 — 하나의 그래프.
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 기반 무료 바이너리입니다.
무료 티어에는 무엇이 포함되나요?
클라우드 Free 티어에는 AI 인지 메모리를 포함한 코어 그래프 워크스페이스가 들어 있습니다. 로컬을 선호한다면 커뮤니티 에디션은 무료 셀프 호스트이고 데이터 한도가 없습니다.
폴더 하나, MCP 연결 하나로 시작하세요.
커뮤니티 에디션은 무료이고 전부 내 컴퓨터에서 실행됩니다. 클라우드는 원할 때 — 원한다면 — 선택하세요.
curl -fsSL https://kumiho.io/install | sh무료 · 단일 사용자 · 전부 내 컴퓨터에서 실행
