🪄 开源 AI 应用构建器

将一句提示词变成一个全栈 Next.js 网页应用——内置托管、沙箱、数据库、认证、AI、GitHub 同步、多租户和自定义域名。

一款免费、可自托管、可白标的替代品，对标 v0、Lovable、Bolt 和 Replit。 自己运行它，或者将一流的 AI 应用构建器直接嵌入你自家的 SaaS。

🚀 快速开始 · 🧩 嵌入你的 SaaS · ☁️ 部署 · 📚 文档 · ⭐ Star 本仓库

---

AI App Builder Open 是一个开源的无代码 AI 应用构建器。用户只需输入他们想要的——例如 “一个带有看板和 Stripe 支付的 CRM”——AI 就会构建、预览并部署一个真实的、全栈的 Next.js 应用。实时预览、代码编辑器、数据库、日志、版本管理和 GitHub 同步均开箱即用。

它由 Totalum VCaaS API（氛围编程即服务）提供支持，后者处理繁重的后端基础设施——托管、沙箱、数据库、AI 代理、自定义域名和 GitHub——只需 一个 API 密钥。你提供前端（本仓库，或你自己的 SaaS）；Totalum 提供平台。

一句话总结： 克隆本仓库，粘贴一个 API 密钥，几分钟内你就拥有了自己的 AI 应用构建器——为自己或你的客户所用。

---

面向人群	你能获得什么
🧑‍💻 开发者和独立黑客	你自己的免费、自托管的 v0 / Lovable / Bolt 替代品。提示词 → 已部署的应用。
🏢 SaaS 与软件公司	将 一流的 AI 应用构建器 嵌入到你的新产品或现有产品中。让你的 用户 在你的 应用 内构建全栈应用。
🎨 代理公司与无代码团队	更快地交付客户应用。白标整个体验。
🧪 创客与非技术用户	无需管理基础设施。一个密钥，一切就绪。

---

以下所有功能只需 一个 API 密钥 即可使用——无需单独的云账户，无需胶水代码：

• 🤖 提示词 → 全栈应用——用通俗语言描述一个应用，AI 代理会构建完整的 Next.js 项目。
• 👀 实时预览——当代理工作时，看到运行中的应用实时更新。
• 🧑‍💻 内置代码编辑器——Monaco（VS Code）编辑器，用于阅读和检查每个生成的文件。
• 🗄️ 托管数据库——每个应用都拥有一个真实的数据库；在界面中浏览、查询和编辑记录。
• 🔐 密钥和环境变量——按项目、按环境管理 API 密钥和环境变量。
• 🚀 一键托管与部署——每个项目都有一个线上地址；即时发布到生产环境。
• 🌐 自定义域名——通过引导式 DNS 设置附加你自己的域名。
• 🔗 双向 GitHub 同步——连接仓库并双向推送/拉取更改。
• 🕓 版本历史——每个 AI 构建版本都是可恢复的检查点；随时回滚。
• 📜 实时服务器日志——检查预览 和 生产环境的运行时日志。
• 🧱 沙箱——每个项目都在隔离的沙箱环境中运行。
• 🏢 多租户就绪——按用户或客户启动隔离的项目，无需额外工作。
• 🎁 漂亮的 git-diff 查看器——按文件审查 AI 所做的具体更改。
• 🌍 任意部署——Vercel、容器或任何 Node.js 主机。完全与部署无关。

---

🚀 快速开始

在 3 分钟内 在本地运行你自己的 AI 应用构建器。

git clone https://github.com/totalumlabs/ai-app-builder-open.git cd ai-app-builder-open npm install

在项目根目录创建 .env（或 .env.local）文件：

TOTALUM_VCAAS_API_KEY=你的密钥

👉 还没有密钥？免费开始——参见下方的 获取你的 API 密钥。

打开 http://localhost:3000，输入你想要构建的内容，然后看着 AI 完成其余工作。🎉

依赖： Node.js 20+ 和 npm。仅此而已。

🔑 获取你的 API 密钥

这个应用运行 唯一 需要的是 Totalum VCaaS API 密钥。获取快速，且 前 50 个 AI 积分免费：

1. 在 www.totalum.app 创建账户。
2. 在引导流程中，选择 “Use the Totalum API” 选项。
3. 复制你的 API 密钥 并将其作为 TOTALUM_VCAAS_API_KEY 粘贴到你的 .env 文件中。

这一个密钥可解锁托管、数据库、AI、自定义域名、GitHub 同步和沙箱——无需其他供应商。📖 完整详情见 Totalum 文档。

⚙️ 环境变量

变量	是否必需	描述
TOTALUM_VCAAS_API_KEY	✅ 是	你的 Totalum VCaaS API 密钥——应用需要的唯一变量。仅保存在服务端；绝不会暴露给浏览器。
NEXT_PUBLIC_APP_URL	⬜ 可选	部署的公开基础 URL（例如 https://your-domain.com）。用于在生产环境中为 CSP/CORS 添加允许列表的源。默认值使用同源地址。

复制示例文件以开始：

cp .env.example .env.local

🔒 安全性： API 密钥仅在服务端 (src/lib/vcaas.ts) 读取，绝不会打包到客户端 JavaScript 中。它 不是 NEXT_PUBLIC_ 变量。

☁️ 部署

这是一个标准的 Next.js 应用，没有平台锁定——可在任何 Next.js 可运行的环境部署。

部署到 Vercel（一键）

导入仓库，在 环境变量 中设置 TOTALUM_VCAAS_API_KEY，然后部署。无需额外配置。

部署到任何 Node.js 主机（虚拟机、容器、Docker、Railway、Render…）

npm run build npm start # 在 $PORT (默认 3000) 提供服务

在主机环境中设置 TOTALUM_VCAAS_API_KEY，将进程管理器或容器指向 npm start，即可上线。在 Nginx 后、Docker 中、VPS 上或任何 PaaS 上都能很好运行。

---

🧩 将其嵌入你自己的 SaaS

这正是 AI App Builder Open 的特别之处：它不仅仅是一个独立工具——它是你产品的一个即插即用的 AI 应用构建层。

无论你是在推出新产品还是已有线上 SaaS，你都可以为你的用户提供 一流的、产品内的 AI 应用构建器，而无需自行构建任何基础设施：

• 🏢 设计上的多租户——每个生成的应用都是隔离的 Totalum 项目。按用户、团队或客户创建项目，并保持一切分离。无需额外管道。
• 🎨 白标——这是你的代码库和你的界面。重新品牌化、重新设计样式，并将其嵌入到你现有的仪表板中。
• 🔌 一次集成，完整平台——单个 API 密钥即可为 你的用户 提供托管、数据库、AI、域名、GitHub 和沙箱。你无需拼接五个供应商。
• 📈 增加新的收入来源——在你现有产品之上，转售应用构建、托管或高级 AI 积分。

向你的客户推销： “在我们的平台内直接构建并交付一个全栈应用。”——由本仓库 + Totalum 驱动，你无需运营任何后端。

阅读集成指南，详见 Totalum 文档 → www.totalum.app/docs。

---

🔐 身份验证、数据库和第三方供应商

生成的应用程序配有托管数据库及运行所需的一切。除此之外，你可以自由添加任何你喜欢的第三方供应商——没有任何锁定：

• 认证——接入 Better Auth（已作为依赖项包含）、Supabase Auth、Clerk、Auth0 或你自己的认证方式。
• 数据库——使用内置数据库，或连接 Supabase、Postgres、PlanetScale、MongoDB 等。
• 支付——Stripe 开箱即用，用于计费和订阅。
• AI——包含 Vercel AI SDK；你可以引入任何模型或供应商。

添加一个供应商只需引入其 SDK 并在 Secrets 面板中配置密钥——无需框架斗争。

---

🧱 架构

┌──────────────────────────────────────────────────────────────┐ │ 本仓库 (Next.js 前端 / 你的 SaaS) │ │ │ │ UI 组件 ──► vcaasApi (客户端目录) │ │ │ 同源 fetch │ │ ▼ │ │ /api/vcaas/* (服务端代理路由) ──► 附加 api-key │ └────────────────────────────┬─────────────────────────────────┘ │ HTTPS + 密钥 API key ▼ ╔═══════════════════════════════════════════╗ ║ Totalum VCaaS API ║ ║ 托管 · 沙箱 · 数据库 · AI ║ ║ 代理 · GitHub · 域名 · 多租户 ║ ╚═══════════════════════════════════════════╝

• 浏览器永远看不到你的 API 密钥。 客户端代码调用同源的 /api/vcaas/* 代理路由；服务端附加凭证并将请求转发给 Totalum。
• 一个服务文件 (src/lib/vcaas.ts) 记录了应用使用的每个 Totalum 端点——易于阅读、扩展和审计。
• Totalum 处理复杂的部分（计算、存储、部署、AI 编排），因此本仓库保持为一个干净、可修改的 Next.js 应用。

---

📁 项目结构

src/ ├─ app/ │ ├─ page.tsx # 仪表板 — 提示框 + 你的项目 │ ├─ project/[projectId]/ # 工作区（聊天、预览、代码、数据库……） │ └─ api/ │ ├─ vcaas/[...path]/ # 代理至 Totalum VCaaS API │ └─ config/ # 报告 API 密钥是否已配置 ├─ components/ │ └─ workspace/ # 聊天、预览、代码、数据库、GitHub、日志…… ├─ lib/ │ ├─ vcaas.ts # 🧠 单一 VCaaS 服务（客户端+服务端） │ └─ vcaas-types.ts # 共享 API 类型 └─ proxy.ts # CORS / CSP 边界

---

🙋 常见问题

它真的是免费的吗？

代码是自由且开源的。运行它需要 Totalum API 密钥，该密钥 可免费开始（前 50 个 AI 积分免费）。你只需在使用规模扩大时付费。请参阅 totalum.app 上的定价。

我需要设置数据库、托管或 AI 提供商吗？

不需要。这就是重点——单一的 Totalum API 密钥即可提供托管、数据库、AI、域名、GitHub 和沙箱。如果你愿意，仍然可以添加自己的供应商（Supabase、Stripe 等）。

我的用户能在我的产品内构建应用吗？

可以。它在设计上就是多租户且白标的——请参见 将其嵌入你自己的 SaaS。

它能构建什么？

全栈 Next.js 网页应用——仪表板、CRM、内部工具、市场、SaaS MVP、带后端的落地页等。

API 密钥存储在哪里？安全吗？

仅服务端。它在 src/lib/vcaas.ts 中读取，绝不发送到浏览器（它不是 NEXT_PUBLIC_ 变量）。客户端请求经过同源代理路由。

我可以在不依赖 Vercel 的情况下自托管吗？

当然。npm run build && npm start 能在任何 Node.js 主机上运行——虚拟机、容器、Docker、Railway、Render、Fly.io 等。

---

📊 对比

AI App Builder Open	v0 · Lovable · Bolt · Replit
开源	✅
可自托管	✅
可白标 / 可嵌入你的 SaaS	✅
开箱即用的多租户	✅
内置托管 + 数据库 + 域名 + GitHub	✅ (一个密钥)
自带供应商 (Supabase, Stripe…)	✅
任意部署	✅

---

📚 文档

完整的平台文档、API 参考和集成指南见于：

• www.totalum.app/docs

---

🤝 贡献

欢迎贡献！无论是错误修复、新增面板、文档还是功能想法：

1. Fork 仓库并创建分支：git checkout -b my-feature
2. 做出你的更改并运行 npm run build 进行验证。
3. 提交一个 pull request 并描述内容和原因。

发现错误或有建议？提出 issue。

---

📄 许可证

依据 MIT 许可证 发布——对个人和商业使用均免费。参见 LICENSE 文件获取更多信息。

🪄 Open-Source AI App Builder

Turn a prompt into a full-stack Next.js web app — with hosting, sandbox, database, auth, AI, GitHub sync, multitenancy & custom domains built in.

A free, self-hosted, white-label alternative tov0, Lovable, Bolt and Replit. Run it yourself, or drop a first-class AI app builder straight into your own SaaS.

🚀 Quick Start · 🧩 Embed in your SaaS · ☁️ Deploy · 📚 Docs · ⭐ Star this repo

---

AI App Builder Open is an open-source, no-code AI app builder. A user types what they want — "a CRM with kanban boards and Stripe billing" — and the AI builds, previews, and deploys a real, full-stack Next.js application. Live preview, code editor, database, logs, versioning and GitHub sync are all included, out of the box.

It's powered by the Totalum VCaaS API (Vibe-Coding-as-a-Service), which handles the heavy backend infrastructure — hosting, sandboxes, databases, AI agents, custom domains and GitHub — behind a single API key. You bring the front-end (this repo, or your own SaaS); Totalum brings the platform.

In one sentence: clone this repo, paste one API key, and you have your own AI app builder running in minutes — for yourself, or for your customers.

---

For…	What you get
🧑‍💻 Builders & indie hackers	Your own free, self-hosted v0 / Lovable / Bolt alternative. Prompt → deployed app.
🏢 SaaS & software companies	Embed a first-class AI app builder into your new or existing product. Let your users build full-stack apps inside your app.
🎨 Agencies & no-code teams	Ship client apps faster. White-label the whole experience.
🧪 Tinkerers & non-tech users	No infrastructure to manage. One key, and everything just works.

---

Everything below works with one API key — no separate cloud accounts, no glue code:

• 🤖 Prompt → full-stack app — describe an app in plain English, the AI agent builds a complete Next.js project.
• 👀 Live preview — see the running app update in real time as the agent works.
• 🧑‍💻 Built-in code editor — Monaco (VS Code) editor to read and inspect every generated file.
• 🗄️ Managed database — each app gets a real database; browse, query, and edit records in the UI.
• 🔐 Secrets & env vars — manage API keys and environment variables per project, per environment.
• 🚀 One-click hosting & deploy — every project gets a live URL; publish to production instantly.
• 🌐 Custom domains — attach your own domain with guided DNS setup.
• 🔗 Bidirectional GitHub sync — connect a repo and push/pull changes both ways.
• 🕓 Version history — every AI build is a restorable checkpoint; roll back anytime.
• 📜 Live server logs — inspect runtime logs from preview and production.
• 🧱 Sandboxes — each project runs in an isolated sandbox environment.
• 🏢 Multitenant-ready — spin up isolated projects per user or per customer, no extra work.
• 🎁 Pretty git-diff viewer — review exactly what the AI changed, file by file.
• 🌍 Deploy anywhere — Vercel, a container, or any Node.js host. Fully deployment-agnostic.

---

Get your own AI app builder running locally in under 3 minutes.

git clone https://github.com/totalumlabs/ai-app-builder-open.git
cd ai-app-builder-open
npm install

Create a .env (or .env.local) file in the project root:

TOTALUM_VCAAS_API_KEY=your_key_here

👉 Don't have a key yet? It's free to start — see Getting your API key below.

Open http://localhost:3000 , type what you want to build, and watch the AI do the rest. 🎉

Requirements: Node.js 20+ and npm. That's it.

---

The only thing this app needs to run is a Totalum VCaaS API key. Getting one is quick and the first 50 AI credits are free :

1. Create an account at www.totalum.app.
2. During onboarding, choose the "Use the Totalum API" option.
3. Copy your API key and paste it into your .env file as TOTALUM_VCAAS_API_KEY.

That single key unlocks hosting, databases, AI, custom domains, GitHub sync and sandboxes — no other providers required. 📖 Full details in the Totalum Docs.

---

Variable	Required	Description
TOTALUM_VCAAS_API_KEY	✅ Yes	Your Totalum VCaaS API key — the only variable the app needs. Kept server-side only; never exposed to the browser.
NEXT_PUBLIC_APP_URL	⬜ Optional	Public base URL of your deployment (e.g. https://your-domain.com). Used to allow-list your origin for CSP/CORS in production. Defaults to same-host.

Copy the example file to get started:

cp .env.example .env.local

🔒 Security: the API key is read only on the server (src/lib/vcaas.ts) and is never bundled into client-side JavaScript. It is not a NEXT_PUBLIC_ variable.

---

This is a standard Next.js app with no platform lock-in — deploy it wherever Next.js runs.

Deploy to Vercel (one click)

Import the repo, set TOTALUM_VCAAS_API_KEY in Environment Variables , and deploy. No extra configuration.

Deploy to any Node.js host (VM, container, Docker, Railway, Render…)

npm run build
npm start          # serves on $PORT (default 3000)

Set TOTALUM_VCAAS_API_KEY in your host's environment, point a process manager or container at npm start, and you're live. Works great behind Nginx, in Docker, on a VPS, or on any PaaS.

---

🧩 Embed it in your own SaaS

This is the part that makes AI App Builder Open special: it's not just a standalone tool — it's a drop-in AI app-builder layer for your product.

Whether you're launching something new or already have a live SaaS, you can offer your users a first-class, in-product AI app builder without building any of the infrastructure yourself:

• 🏢 Multitenant by design — every generated app is an isolated Totalum project. Create one per user, per team, or per customer and keep everything separated. No extra plumbing.
• 🎨 White-label — it's your codebase and your UI. Rebrand it, restyle it, and embed it inside your existing dashboard.
• 🔌 One integration, full platform — a single API key gives your users hosting, databases, AI, domains, GitHub and sandboxes. You don't stitch together five vendors.
• 📈 Add a new revenue stream — resell app-building, hosting or premium AI credits on top of your current product.

The pitch to your customers: "Build and ship a full-stack app right here, inside our platform." — powered by this repo + Totalum, with no backend for you to operate.

Read the integration guide in the Totalum Docs → www.totalum.app/docs.

---

🔐 Auth, database & third-party providers

The generated apps come with a managed database and everything they need to run. On top of that, you're free to add any third-party provider you like — nothing is locked down:

• Auth — plug in Better Auth (already included as a dependency), Supabase Auth, Clerk, Auth0, or your own.
• Database — use the built-in database, or connect Supabase, Postgres, PlanetScale, MongoDB, etc.
• Payments — Stripe is included out of the box for billing and subscriptions.
• AI — the Vercel AI SDK is included; bring any model or provider.

Add a provider by dropping in its SDK and configuring a secret in the Secrets panel — no framework fighting required.

---

┌──────────────────────────────────────────────────────────────┐
│  This repo (Next.js front-end / your SaaS)                    │
│                                                              │
│   UI components ──► vcaasApi (client catalog)                │
│                        │  same-origin fetch                  │
│                        ▼                                     │
│   /api/vcaas/*  (server proxy routes) ──► attaches api-key   │
└────────────────────────────┬─────────────────────────────────┘
                             │  HTTPS + secret API key
                             ▼
        ╔═══════════════════════════════════════════╗
        ║   Totalum VCaaS API                        ║
        ║   hosting · sandboxes · database · AI      ║
        ║   agents · GitHub · domains · multitenancy ║
        ╚═══════════════════════════════════════════╝

• The browser never sees your API key. Client code calls same-origin /api/vcaas/* proxy routes; the server attaches the credential and forwards the request to Totalum.
• One service file (src/lib/vcaas.ts) documents every Totalum endpoint the app uses — easy to read, extend, and audit.
• Totalum handles the hard parts (compute, storage, deploys, AI orchestration), so this repo stays a clean, hackable Next.js app.

---

src/
├─ app/
│  ├─ page.tsx                 # Dashboard — prompt box + your projects
│  ├─ project/[projectId]/     # The workspace (chat, preview, code, DB, …)
│  └─ api/
│     ├─ vcaas/[...path]/      # Proxy to the Totalum VCaaS API
│     └─ config/               # Reports whether the API key is configured
├─ components/
│  └─ workspace/               # Chat, Preview, Code, Database, GitHub, Logs…
├─ lib/
│  ├─ vcaas.ts                 # 🧠 The single VCaaS service (client + server)
│  └─ vcaas-types.ts           # Shared API types
└─ proxy.ts                    # CORS / CSP boundary

---

Is it really free?

The code is free and open source. Running it needs a Totalum API key, which is free to start (your first 50 AI credits are on the house). You only pay as you scale usage. See pricing on totalum.app.

Do I need to set up a database, hosting, or AI provider?

No. That's the whole point — the single Totalum API key provides hosting, databases, AI, domains, GitHub and sandboxes. You can still add your own providers (Supabase, Stripe, etc.) if you want.

Can my users build apps inside my own product?

Yes. It's multitenant and white-label by design — see Embed it in your own SaaS.

What can it build?

Full-stack Next.js web apps — dashboards, CRMs, internal tools, marketplaces, SaaS MVPs, landing pages with backends, and more.

Where's the API key stored? Is it safe?

Server-side only. It's read in src/lib/vcaas.ts and never shipped to the browser (it's not a NEXT_PUBLIC_ variable). Client requests go through same-origin proxy routes.

Can I self-host without Vercel?

Absolutely. npm run build && npm start runs on any Node.js host — VM, container, Docker, Railway, Render, Fly.io, etc.

---

| AI App Builder Open | v0 · Lovable · Bolt · Replit
---|---|---
Open source | ✅ | ❌
Self-hostable | ✅ | ❌
White-label / embeddable in your SaaS | ✅ | ❌
Multitenant out of the box | ✅ | Limited
Built-in hosting + DB + domains + GitHub | ✅ (one key) | Varies
Bring your own providers (Supabase, Stripe…) | ✅ | Limited
Deploy anywhere | ✅ | ❌

---

Full platform documentation, API reference, and integration guides live at:

---

Contributions are welcome! Whether it's a bug fix, a new panel, docs, or a feature idea:

1. Fork the repo and create a branch: git checkout -b my-feature
2. Make your changes and run npm run build to verify.
3. Open a pull request describing what and why.

Found a bug or have an idea? Open an issue.

---

Released under the MIT License — free for personal and commercial use. See the LICENSE file for details.

---

If this project helps you, please give it a ⭐ — it helps others discover it.

Open-source AI app builder · self-hosted v0 / Lovable / Bolt / Replit alternative · prompt-to-app · full-stack Next.js · multitenant · embeddable AI app builder for your SaaS.

Built with ❤️ on top of the Totalum VCaaS API · Docs · Get your free API key