ONEDEV

helix-db

Vector DatabasesCLIRust

★ 5,900주당 +71조회 5

무엇인가

HelixDB는 그래프와 벡터를 1급 데이터 모델로 삼는 OLTP 데이터베이스다. Rust로 처음부터 작성했고 객체 스토리지 위에서 동작한다. 벡터 유사도 검색과 전문 검색을 별도 확장 없이 엔진 안에 넣었다. KV, 문서, 관계형 데이터도 같은 엔진에서 다룬다. AI 애플리케이션의 기억과 지식 그래프를 한 저장소에 두는 자리를 차지한다.

어떻게 동작하나

로컬 인스턴스는 CLI `helix`가 띄우고 관리한다. `helix start dev`가 만드는 개발 인스턴스의 기본 포트는 6969다. 쿼리는 Rust, TypeScript, Go, Python DSL로 작성하며, 각 SDK는 동일한 JSON AST를 만들어 실행 중인 인스턴스에 `POST /v2/query`로 보낸다. 빌드나 배포 단계가 없다. Rust에서는 `#[query]` 함수로 쿼리를 정의하고 `helix-db` 크레이트(임포트명 `helix_db`)의 클라이언트로 바로 실행한다. Cloud 배포는 객체 스토리지를 백엔드로 쓰고 ACID 트랜잭션, 단일 writer와 자동 확장 reader 노드, 3개 이상의 게이트웨이와 DB 노드로 구성된 고가용성을 갖는다. CLI는 WorkOS 세션으로 Cloud 제어면과 중계 쿼리를 처리한다.

무엇과 다른가

일반적인 구성에서는 애플리케이션 DB, 관계형 DB, 벡터 DB, 그래프 DB를 각각 띄우고 저장 위치 사이의 데이터를 맞춰야 한다. HelixDB는 이들을 한 엔진으로 합쳐 그래프·벡터·KV·문서·관계형 데이터를 같은 곳에 저장한다. 쿼리 실행 방식도 다르다. 서버에 함수를 컴파일해 배포하는 대신, 클라이언트가 만든 AST를 HTTP로 보내 즉시 실행한다. 저장 계층은 로컬 블록 스토리지가 아니라 객체 스토리지를 전제로 한다.

어떻게 쓰나

CLI를 설치한 뒤 `helix chef`를 실행하면 대화형 부트스트랩이 한 번에 진행된다. 쿼리 스킬과 문서 MCP를 설치하고, 프로젝트를 스캐폴딩하고, 로컬 인스턴스를 띄우고, 예제 데이터를 넣고, `HELIX_CHEF_PROMPT.md`를 작성한다. 지원 에이전트를 Claude Code → OpenAI Codex → OpenCode → Cursor Agent 순으로 탐지해, 하나라도 있으면 한 줄 설명에서 동작하는 앱을 만들어 넘긴다. 직접 구성하려면 CLI가 생성한 `dev` 인스턴스와 파일을 쓰는 로컬 퀵스타트를 따른다. SDK는 Rust 크레이트, Node.js 20 이상용 TypeScript 패키지, PyPI의 Python 패키지, Go 모듈로 배포된다. 이미 설치했다면 `helix update`로 올린다.

전제와 한계

버전 이름이 세 갈래로 나뉜다. HelixDB v3는 현재 제품과 SDK 세대이고, Helix CLI 3.x는 별도로 릴리스되는 명령줄 클라이언트이며, `POST /v2/query`는 현재 HTTP 와이어 엔드포인트다. 경로의 `v2`는 HelixDB v2나 CLI v2를 뜻하지 않는다. Cloud 쿼리는 인증된 백엔드 브로커를 거치며, 테넌트나 키 생성이 돌려주는 애플리케이션 키는 게이트웨이 직접 클라이언트용이다. CLI는 이 키를 한 번 보여주고 저장하거나 사용하지 않는다. 분산 고가용성 관리형 서비스는 상용이다.

유사 도구