database-build

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

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

开源 unknown 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2954

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类开源模型

开发团队supabase-community

所属国家

官网地址https://database.build

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

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

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

GitHub 星标★ 2954

30天Star增速

HF 下载量

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

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：进阶约 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，检索资料时两个名字都可用。

核心亮点

零安装：浏览器内直接运行真实 Postgres，免去本地环境配置
AI 集成：自然语言生成 SQL，自动解释错误和优化查询
即时分享：一键生成数据库快照链接，便于协作和演示

不足之处

浏览器性能限制，处理大数据集时可能卡顿
数据持久性依赖浏览器存储，不适合生产级数据

适用场景

数据库教学：学生无需安装环境，直接在浏览器练习 SQL
快速原型：验证表结构和查询逻辑，加速开发前设计
数据分析探索：对小型数据集进行即席查询和可视化

替代项目

SQLite Playground、PgBouncer、Neon

项目介绍

database-build 是基础设施领域的开源项目，由 supabase-community 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,954）位列前 30%，在基础设施分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：数据库教学：学生无需安装环境，直接在浏览器练习SQL。同类可对比的替代方案包括 SQLite Playground、PgBouncer、Neon。

上一篇：ramalama

下一篇：WindsurfAPI