HelixDB/helix-db

HelixDB – AI 애플리케이션을 위한 그래프-벡터 데이터베이스

무엇인가요 – HelixDB는 그래프, 벡터, 키-값, 문서, 관계형 스토리지를 하나의 엔진에 통합한 Rust 기반 데이터베이스입니다. 이는 "지식 그래프와 AI 메모리용 데이터베이스"로 마케팅되며, LLM 기반 에이전트가 별도의 DB 제품을 전환하지 않고도 데이터를 질의하고 수정할 수 있도록 합니다.

AI에 왜 중요한가 – 현대의 AI 에이전트는 같은 요청에서 구조화된 지식 (그래프)와 의미적 유사성 (벡터)를 모두 검색해야 하는 경우가 많습니다. HelixDB는 언어별 SDK에서 생성된 JSON 인코딩된 추상 구문 트리(AST)를 수락하는 단일 HTTP POST /v2/query 엔드포인트를 제공합니다. 서버는 ACID 보장을 갖춘 원자적인 혼합 그래프-벡터 쿼리를 실행하며, 전체 텍스트 검색도 지원합니다.

핵심 기능

• 하이브리드 데이터 모델 – 그래프 + 벡터를 주요 모델로 사용하며, KV, 문서, 관계형 테이블도 지원합니다.
• 다중 언어 SDK – Rust, TypeScript, Python, Go는 쿼리 AST를 생성하는 DSL을 제공하며, 동일한 AST를 HTTP로 전송하므로 코드는 언어 간 이식 가능합니다.
• CLI (helix) – 로컬 설치, 개발용 인스턴스 실행, 프로젝트 스크래핑이 가능하며, helix chef 워즈드를 통해 지원되는 AI 에이전트(Claude, OpenAI Codex 등)에 작업을 위임할 수 있습니다.
• HelixDB 클라우드 – 관리형, HA 대응 배포. 객체 스토리지 기반 지속성, 자동 스케일링 리더, 싱글 라이터 트랜잭션, 통합 벡터/전체 텍스트 검색을 제공합니다.
• 버전화된 와이어 프로토콜 – 현재 엔드포인트는 POST /v2/query이며, 버전은 API 버전을 의미하며 제품 버전이 아닙니다.

시작하기 (빠른 시작)

1. CLI 설치

   # macOS / Linux
   curl -sSL https://install.helix-db.com | bash
   # Windows PowerShell
   irm https://raw.githubusercontent.com/HelixDB/helix-db/main/crates/cli/install.ps1 | iex
   

2. 부트스트래퍼 실행

   helix chef   # 프롬프트에 응답하고 실행 가능한 앱 생성
   

   워즈드는 쿼리 SDK를 설치하고 예제 데이터를 시드하며, http://localhost:6969에서 로컬 서버를 시작하고 생성된 앱에 대한 설명이 포함된 HELIX_CHEF_PROMPT.md 파일을 생성합니다.
3. 또는 수동 빠른 시작 – 문서를 참조하여 단계별 로컬 설정을 수행하세요.

예제 쿼리 (Rust)

use helix_db::Client;
use helix_db::dsl::prelude::*;

#[query]
fn add_user(name: String) -> WriteBatch {
    write_batch()
        .var_as("user", g().add_n("User", vec![("name", name)])
            .value_map(None::<Vec<String>>))
        .returning(["user"])
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new(None)?; // localhost:6969로 기본 설정
    let resp: serde_json::Value = client.query(add_user("John Doe".into())?).send().await?;
    println!("new user: {:#}", resp);
    Ok(())
}

TypeScript, Python, Go용 유사 스크립트도 제공됩니다.

일반적인 사용 사례

• RAG / 검색 기반 생성 – 문서를 벡터로 저장하고, 그래프 관계(예: 주제, 저자)로 연결하여 단일 쿼리로 관련 청크를 검색.
• 에이전트 메모리 – LLM 에이전트의 내부 상태, 사실, 임베딩을 지속적으로 저장하여 과거 상호작용을 기억하고 추론할 수 있도록 함.
• 지식 그래프 기반 앱 – 관계 조인과 의미적 유사성을 모두 필요로 하는 추천, 사기 탐지, 공급망 시스템 구축.
• 하이브리드 AI 파이프라인 – 구조화된 비즈니스 데이터(SQL 유사 테이블)와 비구조화된 임베딩을 서비스 간 데이터 이동 없이 통합.

생태계 및 커뮤니티

• 문서 및 튜토리얼 – https://docs.helix-db.com (쿼리 가이드, SDK 설정, 클라우드 배포)
• Discord – 문제 해결 및 기능 논의를 위한 활성 커뮤니티.
• Y-Combinator 런칭 – 초기 단계의 후원으로 상업적 관심을 보여줌.
• 오픈소스 리포지토리 – 핵심 엔진과 CLI는 HelixDB/helix-db GitHub 리포지토리에 있으며, Rust 크레이트는 helix-db (v3.0.0)로 공개됨.

라이선스

리포지토리는 오픈소스입니다 (README에 라이선스가 명시되어 있지 않지만, 코드는 GitHub과 crates.io에 공개되어 있어 사용 및 기여가 가능합니다).

---

HelixDB는 AI 중심 워크로드를 위한 통합 솔루션을 목표로 하며, 개발자가 그래프 구조, 벡터 유사성, 전통적 데이터 모델을 모두 아우르는 단일 쿼리를 작성할 수 있도록 합니다.