database-build

浏览器里玩转 Postgres，AI 帮你写 SQL

开源 🏷️定价信息待确认 ✅ 目前可打开开源模型 🍴 复刻 271 🐛 待处理 49 👀 关注 27

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2950

维护状态低维护

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

database-build 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开源模型

开发团队supabase-community

官网地址https://database.build

GitHubhttps://github.com/supabase-community/database-build

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型ai,browser,llm,pglite,postgres

GitHub 星标★ 2950

上线时间2024-07-22 00:00:00

代码更新2026-06-03

仓库体积25.1 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数7

项目介绍

database-build 是一个在浏览器中运行的 Postgres 沙箱环境，并集成了 AI 辅助功能（前身为 postgres.new）。它允许用户无需安装任何数据库软件，直接在浏览器里创建、查询和管理 PostgreSQL 数据库，同时通过 AI 助手自然语言生成 SQL、解释查询结果、优化表结构等。项目解决了数据库学习和原型开发中环境搭建繁琐、数据不可持久化的问题，核心能力包括：基于 WebAssembly 的本地数据库引擎、AI 驱动的 SQL 生成与调试、可视化表结构编辑、以及一键分享数据库快照。它适合教学演示、快速验证数据模型和探索性数据分析，让数据库操作变得轻量、即时且智能。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2950

技术标签

ai browser llm postgres

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 25 分钟部署方式：本地安装 7 步

环境要求

Node.js 与 npm（用于 npm i 安装依赖）
Docker 与 docker compose（用于启动本地 Redis 容器）
可运行 npx（Supabase CLI 通过 npx supabase 调用）
一个 OpenAI API Key（AI 功能所需）
各子应用的 .env.example 中列出的其余环境变量

安装与启动步骤

1安装依赖

在 monorepo 根目录执行，安装 Web、browser-proxy、deploy-worker 等所有子项目的依赖。
```
npm i
```
2启动本地 Supabase

用 npx 拉起本地 Supabase 栈，为 Web 应用提供本地后端服务。
```
npx supabase start
```

3写入 Supabase 变量

把本地 Supabase 的 URL 与 anon key 以 NEXT_PUBLIC 前缀追加进 apps/web/.env.local。

npx supabase status -o env \
  --override-name api.url=NEXT_PUBLIC_SUPABASE_URL \
  --override-name auth.anon_key=NEXT_PUBLIC_SUPABASE_ANON_KEY |
    grep NEXT_PUBLIC >> ./apps/web/.env.local

4配置 OpenAI 密钥

在 OpenAI 平台创建 API key，写入 apps/web/.env.local，供 AI 生成 SQL 等功能使用。
```
echo 'OPENAI_API_KEY="sk-xxxxxxxx"' >> ./apps/web/.env.local
```

5写入 KV 变量

README 要求使用这两个固定值作为本地 Redis（KV）配置，直接追加进 .env.local。

echo 'KV_REST_API_URL="http://localhost:8080"' >> ./apps/web/.env.local
echo 'KV_REST_API_TOKEN="local_token"' >> ./apps/web/.env.local

6启动 Redis 容器

运行 web 目录下的 docker compose，启动用于速率限制的本地 Redis，API 监听 8080 端口。
```
docker compose -f ./apps/web/docker-compose.yml up -d
```
7补全其余变量

按各应用的 .env.example 填写剩余环境变量，缺项会导致 Web、代理或部署 worker 无法正常工作。

关键配置

配置项	必填	说明	示例
`NEXT_PUBLIC_SUPABASE_URL`	是	本地 Supabase 的 API 地址，由 supabase status 命令自动写入	`http://127.0.0.1:54321`
`NEXT_PUBLIC_SUPABASE_ANON_KEY`	是	本地 Supabase 的匿名密钥，由 supabase status 命令自动写入	`eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`
`OPENAI_API_KEY`	是	OpenAI 密钥，用于 AI 辅助的 SQL 生成与解释	`sk-xxxxxxxx`
`KV_REST_API_URL`	是	本地 Redis（KV）REST 地址，README 要求用固定值	`http://localhost:8080`
`KV_REST_API_TOKEN`	是	本地 Redis（KV）访问令牌，README 要求用固定值	`local_token`

如何确认成功

README 未给出启动命令；确认 supabase 与 Redis 容器已运行、apps/web/.env.local 中变量已写入即可。

常见问题

Q：必须安装 PostgreSQL 吗？

A：不需要。数据库由浏览器内的 PGlite（WASM 版 Postgres）运行，数据存在 IndexedDB 中，刷新后仍保留。

Q：为什么还要启动 Supabase 和 Redis？

A：本地 Supabase 提供应用后端，Redis 容器用于速率限制，其 API 固定在 8080 端口，不能用其他端口替代。

Q：没有 OpenAI API key 能跑吗？

A：README 将 OPENAI_API_KEY 列为必填步骤，AI 生成 SQL、图表、报表等功能依赖它，缺失会报错。

Q：monorepo 里有哪些应用？

A：apps/web（Next.js 主应用）、apps/browser-proxy（用 WebSocket 代理 Postgres TCP 连接）、apps/deploy-worker（把浏览器数据库部署到 Supabase 等平台）。

注意事项

本项目是 monorepo，所有命令都在仓库根目录执行。
KV_REST_API_URL 与 KV_REST_API_TOKEN 必须使用 README 给出的 localhost:8080 与 local_token。
README 未提供开发服务器启动命令与访问地址，需自行参考各子应用的 scripts。
项目前身为 postgres.new，检索资料时两个名字都可用。