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核心工作负载的一站式解决方案，让开发者编写一条跨越图结构、向量相似性和传统数据模型的单一查询。