Repolode
HelixDB

HelixDB/helix-foundry

本地优先的数据工作台,把数据库、SaaS 工具和文件连接成统一本体,可在自己电脑上查询分析。

Star
1,626
Fork
243
未关闭 Issue
17
最近提交
7天前

这是什么?

Helix Foundry 可连接企业已在使用的数据源,包括 PostgreSQL、MySQL、Neo4j、Stripe、WorkOS、PostHog、REST API、S3 兼容存储,以及 CSV、JSON、JSONL、Parquet 格式的文件上传。它会把不同来源中的同一客户和记录对应起来,生成一套统一本体,以对象和关系的形式存入 HelixDB,供你浏览和提问。

整个应用通过 Docker Compose 在本机运行,无需注册账号,也没有托管服务。导入的数据会保存为不可变的 Parquet 快照,由彼此隔离的 DuckDB 进程查询。在 Analyst 视图中提出的问题会附上实际执行的 SQL 和快照引用作为依据。

默认使用通过 Ollama 本地运行的 qwen3:4b 模型,也可以切换到 Claude、OpenAI、Azure OpenAI、Amazon Bedrock 或兼容 OpenAI 接口的自定义端点。AI 提出的修改会先经过测试,并等待你审核后才会生效。

核心功能

  • 01连接 PostgreSQL、MySQL、Neo4j、Stripe、WorkOS、PostHog、REST API 和 S3 兼容存储
  • 02支持导入 CSV、JSON、JSONL、Parquet 文件,并提供数据摄取 API
  • 03自动建议统一本体,关联不同来源中的同一记录
  • 04以带版本的 Parquet 快照保存数据,并支持结构变化审查与历史记录
  • 05回答问题时附带实际执行的 SQL 和快照引用
  • 06默认使用 Ollama 本地 AI,也可切换为 Claude 或 OpenAI

适用场景

  • 在不使用托管服务的前提下,把生产数据库、Stripe 和产品分析数据中的客户信息合并查看
  • 梳理账户、订阅、账单和支持工单之间的关联关系
  • 在本机保留数据的前提下,用自然语言询问公司数据
  • 为独自处理敏感记录的人搭建自托管的数据工作台

快速上手

  1. 1

    确保已安装并运行带 Compose v2 的 Docker

  2. 2

    克隆仓库

    git clone https://github.com/helixdb/helix-foundry.git
  3. 3

    进入项目目录

    cd helix-foundry
  4. 4

    运行安装脚本并用 Docker Compose 启动服务

    ./scripts/setup.sh --compose

使用前须知

  • 主要在 macOS(Apple Silicon)上开发和验证;Windows 未经测试,脚本需要 bash。
  • 需要 Docker,首次运行需下载数 GB 内容。
  • 本地 AI 在 16 GB 内存机器上测试;若选择云端 AI,需要 Claude 或 OpenAI 的付费密钥。

标签

常见问题

helix-foundry 是什么?
本地优先的数据工作台,把数据库、SaaS 工具和文件连接成统一本体,可在自己电脑上查询分析。 Helix Foundry 可连接企业已在使用的数据源,包括 PostgreSQL、MySQL、Neo4j、Stripe、WorkOS、PostHog、REST API、S3 兼容存储,以及 CSV、JSON、JSONL、Parquet 格式的文件上传。它会把不同来源中的同一客户和记录对应起来,生成一套统一本体,以对象和关系的形式存入 HelixDB,供你浏览和提问。
helix-foundry 可以免费使用吗?用的什么许可证?
helix-foundry 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
helix-foundry 还在维护吗?
活跃维护中。helix-foundry 最近一次提交是在 2026年10月13日。
helix-foundry 适合用来做什么?
在不使用托管服务的前提下,把生产数据库、Stripe 和产品分析数据中的客户信息合并查看 梳理账户、订阅、账单和支持工单之间的关联关系 在本机保留数据的前提下,用自然语言询问公司数据 为独自处理敏感记录的人搭建自托管的数据工作台
helix-foundry 怎么安装和运行?
确保已安装并运行带 Compose v2 的 Docker 克隆仓库: git clone https://github.com/helixdb/helix-foundry.git 进入项目目录: cd helix-foundry 运行安装脚本并用 Docker Compose 启动服务: ./scripts/setup.sh --compose
在哪里获取 helix-foundry?
源代码和安装说明在 GitHub 上:https://github.com/HelixDB/helix-foundry

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目