자산 그래프 위에서 빌드하세요.
파일 더미 위에서 말고.

SDK로 안정적인 식별자, 버전 히스토리, 계보 엣지, 이벤트를 바로 쓸 수 있어요. 멀티테넌트 그래프 백엔드를 직접 만들 필요 없이.

2분이면 시작

복사하고, 붙여넣고, 실행. 끝.

quickstart.py

# 설치
$ pip install kumiho

# 인증 (캐시된 자격증명 또는 환경 변수 토큰 사용)
import kumiho
kumiho.auto_configure_from_discovery()

# 프로젝트 생성 또는 조회
project = kumiho.create_project("demo-project", "Demo Project")

# 스페이스로 자산 정리
space = project.create_space("characters")

# 아이템(자산) 생성
item = space.create_item("hero", kind="image")

# 메타데이터와 함께 새 버전 등록
revision = item.create_revision(
    metadata={
        "model": "sdxl",
        "prompt": "cinematic portrait, dramatic lighting",
        "seed": 18423,
        "tool": "ComfyUI"
    }
)

# 업로드 없이 파일 연결
revision.create_artifact(
    name="output",
    location="/mnt/assets/hero_v01.png"
)

# 필요하면 계보 연결
revision.create_edge(
    edge_type="CREATED_FROM",
    source_kref="kref://demo-project/characters/sketch.image?r=3"
)

print("버전 등록됨:", revision.kref)

계보를 얻는 최소 코드

파일은 기존 스토리지에 그대로

모든 쓰기가 이벤트 발생

패턴 선택하기

대부분의 개발자는 이 중 하나에요

플러그인 통합

DCC, ComfyUI, 기타 크리에이티브 도구용 플러그인을 만드세요. 생성 시점의 맥락을 캡처해요.

Maya • Houdini • Nuke • ComfyUI

파이프라인 서비스

렌더팜, 처리 큐, CI/CD에서 배치로 가져오세요. 완료될 때 결과물을 등록해요.

렌더팜 • 배치 작업 • CI/CD

제품 백엔드

Kumiho를 내 앱의 자산 레지스트리로 쓰세요. 버전 관리, 계보, 이벤트가 기본으로 제공돼요.

자사 앱 • SaaS • 내부 도구

AI 인지 메모리

Kumiho를 AI 에이전트의 메모리 백엔드로 쓰세요. 같은 그래프 프리미티브로 메모리를 저장, 회수, 통합하세요.

에이전트 프레임워크 • AI 어시스턴트 • 채팅 앱

기술 상세

개발자가 진짜 궁금해하는 것만

kref: 안정적인 식별자

모든 자산에 kref가 부여돼요 — 안정적이고 사람이 읽을 수 있는 URI:

kref://project/space/item.kind?r=revision

깨지기 쉬운 파일 경로 없이도 시스템 간에 자산을 참조할 수 있어요. kref는 기본적으로 최신 버전을 가리키고, 특정 버전에 고정할 수도 있어요.

버전 불변성

한번 생성된 버전은 불변이에요. 할 수 있는 것:

기존 버전에 메타데이터나 아티팩트 추가
버전 간 엣지 생성
버전 게시 또는 보관

콘텐츠를 수정하거나 히스토리를 삭제할 수는 없어요. 덕분에 재현성과 감사 추적이 보장돼요.

엣지 타입 (depends_on, derived_from)

엣지는 버전 간 관계를 나타내요:

DEPENDS_ON런타임 의존성 — 소스가 바뀌면 대상도 업데이트가 필요할 수 있음

DERIVED_FROM계보 — 대상이 소스로부터 생성됨

REFERENCES소프트 링크 — 정보 목적

영향 분석할 때 엣지를 탐색하세요: "이거에 뭐가 의존하지?" 또는 "이건 뭐에서 파생됐지?"

이벤트 스트리밍

모든 쓰기 작업이 이벤트를 발생시켜요:

item.created, revision.created, edge.created
revision.updated, revision.tagged, revision.deleted

웹훅 구독이나 폴링으로 받아보세요. 반응형 파이프라인을 만들고, AI 에이전트를 연결하고, 다운스트림 자동화를 트리거하세요.

AI 인지 메모리 API

같은 그래프 프리미티브를 에이전트 메모리에 활용하세요:

memory_store()타입 엣지와 메타데이터와 함께 대화 요약 저장

memory_recall()시맨틱 쿼리로 전체 출처와 함께 메모리 검색

memory_consolidate()Dream State를 실행해서 메모리 보강, 연결, 정리

메모리는 타입 엣지를 가진 불변 리비전이에요 — 자산 계보와 같은 프리미티브를 AI 에이전트 회수에 적용한 거예요.

왜 S3 + DB만으로는 안 되나요?

솔직한 비교

필요한 것	S3 + DB	Kumiho
바이트 저장	✓ 가능	— 스토리지는 직접 사용
안정적 식별자	직접 구축	✓ kref 기본 제공
버전 히스토리	직접 구축	✓ 핵심 기능
계보 / 의존성 그래프	직접 구축	✓ 네이티브 엣지
이벤트 스트리밍	직접 구축	✓ 모든 쓰기마다
멀티테넌트 격리	직접 구축	✓ 기본 제공

Kumiho는 바이트가 아니라 의미를 저장해요. 파일은 여러분이 보관하고, 저희는 그게 뭐고 어떻게 연결되는지 추적해요.

실제 통합을 위한 SDK

🐍

Python

pip install kumiho

⚙️

C++

vcpkg / CMake

🌐

REST API

FastAPI 엔드포인트

🎯

Dart

pub add kumiho

자산을 히스토리가 있는 객체로 다루세요.

버전 추적, 계보 그래프, 이벤트 시스템을 또 만들지 마세요. 여러분의 제품에 집중하세요.

문서 보기 GitHub 보기

자산 그래프 위에서 빌드하세요.파일 더미 위에서 말고.