Unbody

Unbody 正在构建 AI 时代的 Supabase。

如今，构建 AI 功能是一个复杂且分散的过程。Unbody 正在解决这一问题。我们继续以开源的方式推进项目。目前项目仍处于早期开发阶段，因此可能会存在一些不完善之处。

快速开始

注意: 这些步骤提供了一个基础设置。如需更详细的指导，请加入我们的 Discord 社区。

前置条件

• Node.js LTS（20 或 22）
• Docker 和 Docker Compose
• yarn（使用 npm 可能无法正确安装依赖）
• OpenAI API 密钥

安装

# 克隆仓库
git clone https://github.com/unbody-io/unbody

# 进入项目目录
cd unbody

# 安装 Node 模块
yarn

环境配置

# 从模板创建 .env.local 文件
cp .env.example .env.local

# 使用你喜欢的编辑器打开，并添加你的 OpenAI API 密钥
vim .env.local

运行应用

# 启动所需的服务
docker compose up -d

# 启动应用
yarn start

创建你的第一个项目

我们为你准备了一个演示项目，方便你快速上手：

# 克隆示例仓库
git clone https://github.com/unbody-io/examples.git
cd examples

添加数据源

# 将示例仓库中的 storage/ 目录作为数据源添加到 Unbody
yarn unbody-cli source add

监控索引进度

前往 http://localhost:8233/ 的 Temporal 控制台，查看文件正在被索引的情况。

注意：

• 需要手动刷新控制台才能获取最新状态
• 索引完成后，请按照示例仓库中的 README 操作

如果在设置过程中遇到任何问题，或希望向我们提供反馈，请加入我们的 Discord 社区，我们将很乐意解答您的疑问。

链接

• 官网
• 博客
• Twitter
• Discord

Unbody 快速上手指南

Unbody 致力于打造 AI 时代的 Supabase，旨在简化当前复杂且碎片化的 AI 功能开发流程。本指南将帮助你快速在本地搭建并运行 Unbody。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• Node.js: LTS 版本（推荐 v20 或 v22）
• 包管理器: 必须使用 yarn（npm 无法正确安装依赖）
• 容器工具: Docker 和 Docker Compose
• API 密钥: 有效的 OpenAI API Key
• 操作系统: 支持 Docker 的 macOS、Linux 或 Windows (WSL2)

提示：国内开发者若遇到 npm/yarn 源连接缓慢，可临时切换至淘宝镜像源：

yarn config set registry https://registry.npmmirror.com

安装步骤

1. 克隆项目与安装依赖

# 克隆仓库
git clone https://github.com/unbody-io/unbody

# 进入项目目录
cd unbody

# 安装节点依赖（务必使用 yarn）
yarn

2. 配置环境变量

# 从模板创建本地环境配置文件
cp .env.example .env.local

# 编辑配置文件，填入你的 OpenAI API Key
# 推荐使用 vim, nano 或 VS Code 编辑
vim .env.local

请在 .env.local 文件中找到对应字段并填入你的 OPENAI_API_KEY。

3. 启动服务

# 后台启动所需的 Docker 服务（数据库、Temporal 等）
docker compose up -d

# 启动 Unbody 应用
yarn start

基本使用

完成上述安装后，你可以通过官方提供的示例项目快速体验核心功能。

1. 获取示例项目

# 克隆示例仓库
git clone https://github.com/unbody-io/examples.git
cd examples

2. 添加数据源

在示例项目目录下，运行 CLI 命令将数据存储目录添加为 Unbody 的数据源：

# 将 storage/ 目录添加为数据源
yarn unbody-cli source add

按提示操作即可完成数据源绑定。

3. 监控索引进度

打开浏览器访问 Temporal 仪表盘，查看文件索引状态：

• 地址: http://localhost:8233/

注意：

• 仪表盘不会自动刷新，需手动刷新页面以获取最新状态。
• 待索引完成后，请参考 examples 仓库的 README 进行后续的查询与集成开发。

如需更多帮助或反馈，欢迎加入官方 Discord 社区交流。