Kumiho 서버를 실행하세요. 여러분의 머신에서.
Community Edition은 Kumiho 그래프 서버의 무료 단일 사용자 빌드입니다. 전적으로 여러분의 머신에서 동작하며, 로컬 Neo4j(그리고 선택적 로컬 Redis)와만 통신하고, 계정·토큰·클라우드 연결이 필요 없습니다. 한 줄로 설치하면 나머지는 가이드 마법사가 처리합니다.
Kumiho를 실행하는 두 가지 방법
호스팅 무료 티어와 Community Edition 모두 무료입니다. 서버를 어디에 둘지, 그리고 두 명 이상이 접근해야 하는지에 따라 선택하세요.
Kumiho 클라우드 (무료 티어)
우리가 운영하는 관리형 인프라입니다. 설치할 것이 없고, 멀티 사용자 및 에이전트 대응이 되며, AI 인지 메모리와 크로스 세션 리콜이 포함됩니다.
- Neo4j, Redis, 서버를 우리가 호스팅
- 무료 5,000 노드 — 실제 평가 영역
- 팀 협업 및 공유 접근
- Creator / Studio로 그 자리에서 업그레이드
Community Edition (셀프 호스트)
여러분이 직접 실행하는 단일 바이너리입니다. 루프백 전용, 토큰 없음, 완전 로컬 — 그래프가 머신을 떠나지 않습니다. 단일 사용자에게 노드 무제한.
- Neo4j(및 선택적 Redis)를 로컬에서 직접 실행
- 데이터 한도 없음 — 단일 사용자 그래프는 무제한
- 계정·토큰·네트워크 연결 불필요
- 단일 사용자·로컬 전용 — 공유 백엔드 아님
한 줄로 설치
인스톨러가 최신 릴리스 바이너리를 받아 SHA-256 체크섬을 검증(불일치 시 중단)하고, ~/.kumiho/bin에 설치한 뒤 온보딩 마법사로 넘깁니다.
# One-line install (macOS / Linux)
curl -fsSL https://github.com/KumihoIO/kumiho-server-community/releases/latest/download/install.sh | sh
# then — re-run the wizard any time
kumiho_server onboard# One-line install (Windows · PowerShell)
irm https://github.com/KumihoIO/kumiho-server-community/releases/latest/download/install.ps1 | iex
# then — re-run the wizard any time
kumiho_server onboard- GitHub에서 최신 릴리스 바이너리 다운로드
- SHA-256 체크섬 검증 — 불일치 시 중단(fail-closed)
- ~/.kumiho/bin에 설치
- 내장 온보딩 마법사 실행
설정 — kumiho_server onboard
인스톨러가 내장 온보딩 마법사로 넘깁니다(언제든 kumiho_server onboard로 다시 실행). ~/.kumiho/server.toml에 권한이 제한된 설정과 실행 스크립트를 작성하고, 곧바로 서버를 시작할 수 있습니다.
- 로컬 사용자명 / 이메일 — 생성 데이터 귀속용, 기본값은 OS 사용자
- Neo4j 연결 — 포트, 데이터베이스, 자격 증명
- 선택적 로컬 Redis 포트 — 이벤트 스트림 활성화
- 서버 포트 — 기본값 127.0.0.1:9190
- 선택적 OpenAI 임베딩 — 벡터 / 시맨틱 검색
- EULA 수락
요구사항
Docker는 데이터베이스를 로컬에서 실행하는 편리한 방법입니다.
Neo4j 5.x
로컬 인스턴스. 번들되지 않음 — 직접 준비하세요.
Redis 7.x
설정 시 이벤트 스트림을 활성화합니다.
OpenAI API 키
임베딩 / 시맨틱 검색을 활성화합니다.
# Local databases via Docker (Kumiho runs on the host, not in these containers)
docker run -d --name kumiho-neo4j -p 7687:7687 -p 7474:7474 \
-e NEO4J_AUTH=neo4j/your-local-password neo4j:5
docker run -d --name kumiho-redis -p 6379:6379 redis:7
# Point onboarding at the published host ports (7687, 6379)CE가 무엇인지 — 그리고 무엇이 아닌지
CE는 단일 사용자·루프백 전용 빌드입니다. 에디션은 컴파일 시점에 잠겨 있어 클라우드나 멀티 테넌트 서버로 재구성할 수 없습니다.
루프백 전용
127.0.0.1에만 바인딩하고 비루프백 피어를 거부합니다. 로컬 접근만 가능.
단일 사용자 동시성 제한
내장 제한이 한 사용자를 원활하게 유지하면서 두 번째 동시 사용자를 거부합니다. 공유 백엔드가 아닙니다.
토큰 없음 · 비인증
루프백 / 피어 검사는 보안 경계가 아니라 격리입니다. CE를 네트워크에 노출하거나 프록시 뒤에 두지 마세요.
데이터 한도 없음
노드나 데이터 제한이 없습니다 — 단일 사용자 그래프는 무제한입니다.
다운로드 수동 검증
모든 릴리스에 checksums.txt가 포함되어 실행 전에 바이너리를 확인할 수 있습니다.
# Every release ships checksums.txt
sha256sum -c checksums.txt # Linux
shasum -a 256 -c checksums.txt # macOS헬스 체크
서버가 살아 있고 self-hosted CE 모드로 동작하는지 확인하세요.
# With the server running
curl http://127.0.0.1:9190/api/_live
# {"status":"ok","version":"x.y.z","deployment_mode":"self_hosted_ce"}
# /api/_health additionally reports Neo4j, Redis, and embedding readiness라이선스 & 범위
Community Edition은 Community Edition EULA에 따라 바이너리 형태로 배포됩니다. 단일 사용자·로컬 사용(개인, 개발, 내부, 상업용)에 한해 라이선스됩니다. 호스팅·공유·멀티 사용자·팀·프로덕션 백엔드 서비스로 운영하거나 더 높은 동시성이 필요하면 별도의 상업적 계약이 필요합니다.
문서
전체 런북(self-hosted-ce.md)이 모든 릴리스 아카이브에 포함되어 있으며 구성, Docker, Python SDK, 보안 모델을 다룹니다.
관련 자료
무료. 로컬. 여러분이 운영합니다.
머신을 떠나지 않는 단일 사용자 그래프를 원하면 Community Edition을 설치하세요 — 우리가 관리하는 멀티 사용자·에이전트 대응 메모리가 필요하면 호스팅 무료 티어로 시작하세요.