AB
AB
AiBoss站

全部分类

project

helix-foundry - 把企业数据接成一张可提问的图

helix-foundry 是 HelixDB 维护的开源项目：连接 PostgreSQL、MySQL、S3、Stripe 等数据源与文档、表格文件，由 agent 起草本体（类型、链接、规则），经人工审阅后载入 HelixDB，形成可浏览、可溯源、可带引用问答的连通图。支持托管使用或本地 Docker 部署，采用 Apache-2.0 许可。

helix-foundry 是 HelixDB 维护的一个开源项目，目标是把一家公司分散在各处的数据接到一起：先连上数据库、SaaS 服务和文件，再由一个 agent 在这些数据之上起草一份本体（ontology），也就是类型、类型之间的链接、每个类型来自哪些表或文档，以及相应的规则。人审阅、修改并确定版本之后，项目把该版本写入 HelixDB，形成一张连通的图，可以按图浏览、按记录浏览，把每个值回溯到它所在的行或原文引句，并用带引用的答案来回答问题。它适合希望把多源数据整理成统一语义层、又不想从零搭建数据接入与建模流程的团队，也适合想在本机快速试跑这套流程的开发者。

维护者与状态

项目由 HelixDB 维护，仓库为 HelixDB/helix-foundry。仓库创建于 2026-10-07，最后一次提交在 2026-10-27，属于相当年轻的项目。截至 2026-10-28，仓库获得 1679 个星标。事实表显示该项目尚无正式 release，也就是说目前没有可供引用的版本号，使用时应以仓库当前代码为准。项目另有一个托管站点，地址见下方「使用入口」。

主要能力

以下能力来自项目自述（README），属于维护者对自身功能的描述，未经本站独立验证。

  • 多源连接：据项目说明，可连接 PostgreSQL、MySQL、Amazon S3、Stripe、PostHog、WorkOS、GitHub、Linear、Granola 与 Cal.com，并可上传文档（Markdown、文本、PDF）与表格文件（CSV、TSV、JSON、JSON Lines、Parquet）。
  • agent 起草本体：agent 会起草类型、链接、每个类型对应的来源表与文档，以及规则；用户审阅、编辑后，把某个版本设为当前版本。
  • 载入与浏览：一次载入会把选定版本写入 HelixDB，之后既能以图的形式浏览，也能以记录的形式浏览。
  • 溯源与问答：README 称每个值都能回溯到它所在的行或原文引句，提问得到的答案带有引用。
  • 两种使用形态：既可以使用托管版本，也可以在自己的电脑上运行。

使用入口

代码仓库：HelixDB/helix-foundry。托管站点：foundry.helix-db.com。

据项目说明，本地运行需要 Docker 与 Compose v2，步骤为克隆仓库、进入目录后启动容器：

git clone https://github.com/helixdb/helix-foundry.git
cd helix-foundry
docker compose up -d --wait

随后访问 http://localhost:3000 即可。README 称本地模式没有登录环节、无需额外配置：只有一个 owner，所有连接器与功能默认开启，并自带一个可用的工作区。首次启动会把该安装的密钥写入一个 Docker 卷，需要保留该卷；README 明确提示 docker compose down -v 会连同数据一起删除它。

关于模型来源，项目说明给出的顺序是：如果执行 docker compose up 的 shell 中存在 ANTHROPIC_API_KEY 或 OPENAI_API_KEY，就使用 Claude 或 OpenAI；否则使用在 Ollama 中调用工具的模型（可用 docker compose --profile ollama up -d 在 Foundry 旁边跑一个，也可使用本机已有的 Ollama）；再否则使用本机的 LM Studio。设置中的「AI models」页面会说明它选了哪一个以及原因，并允许改用 Ollama、Claude、OpenAI、Azure OpenAI、Amazon Bedrock（自带密钥），或任何兼容 OpenAI 接口的服务（如 vLLM、网关）。README 还提到 local/README.md 记录了运行了哪些组件、数据存放位置、哪些配置可覆盖、各提供方如何设置，以及如何访问本机上的数据库。

仓库同时包含前端与后端：根目录是站点、Foundry 应用及其同源 API 代理（Next.js），需要 Node 24 与 pnpm，可用 pnpm install 后执行 pnpm dev:mock 或 pnpm dev:mock:local 以 mock API 启动；提交改动前建议运行 pnpm typecheck、pnpm lint、pnpm test 与 pnpm e2e（Playwright，需先安装 Chromium）。backend/ 是 Go 模块 github.com/helixdb/helix-foundry/backend，包含 API、负责同步数据、起草本体、载入 HelixDB 与回答问题的 worker，以及它们的 MySQL 存储；README 称托管版 Helix 以库的形式运行同一份代码。

许可与限制

许可证为 Apache-2.0。据项目说明，仓库中的站点与后端，以及 Foundry 的三个镜像（由本仓库构建的 foundry-site 与 foundry，以及本体 agent 的 ontology-agent）均为 Apache 2.0；本地 compose 文件一并运行的 HelixDB 同样是 Apache 2.0。

已知限制与前置条件方面，素材中明确写到的有：本地运行依赖 Docker 与 Compose v2；首次启动生成的密钥保存在 Docker 卷中，删除该卷会丢失数据；AI 能力依赖外部模型提供方，需要相应的 API key 或本机运行的 Ollama、LM Studio 等，具体可用模型取决于环境配置；开发前端需要 Node 24 与 pnpm，端到端测试还需额外安装 Chromium。除此之外，项目自述未给出性能指标、数据规模上限或硬件配置要求，这些信息在仓库当前状态下无法确认。

返回