HelixDB/helix-db

HelixDB – 為AI應用打造的圖-向量資料庫

是什麼 – HelixDB 是以 Rust 實作的資料庫，將圖、向量、鍵值、文件與關聯式儲存整合於單一引擎中。它被定位為「知識圖譜與AI記憶的資料庫」，讓LLM驅動的智能體無需切換多個資料庫產品，即可查詢與修改資料。

對AI為何重要 – 現代AI智能體經常需要在同一請求中取得 結構化知識（圖）與 語意相似性（向量）。HelixDB 提供單一的 HTTP POST /v2/query 端點，接收由語言特定 SDK 產生的 JSON 編碼抽象語法樹（AST）。伺服器隨後原子性地執行混合圖-向量查詢，具備 ACID 保證與全文搜尋功能。

核心功能

• 混合資料模型 – 圖 + 向量為主要模型；亦支援 KV、文件與關聯式表格。
• 多語言 SDK – Rust、TypeScript、Python 與 Go 提供 DSL，用以建構查詢 AST；相同的 AST 透過 HTTP 傳送，因此程式碼可在不同語言間移植。
• CLI（helix） – 可本地安裝，啟動開發實例，產生專案範本，並可透過 helix chef 導覽程式，將任務交由支援的AI智能體（如 Claude、OpenAI Codex 等）處理。
• HelixDB Cloud – 管理式、高可用部署，基於物件儲存的持久化，支援自動擴展讀節點、單寫入事務，以及整合的向量/全文搜尋。
• 版本化網路協定 – 目前端點為 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核心工作負載的一站式解決方案，讓開發者撰寫一條跨越圖結構、向量相似性與傳統資料模型的單一查詢。