RoomGPT：上传房间照片，用 AI 生成你的梦想房间（开源版）
RoomGPT 是 RoomGPT.io（付费 SaaS 产品）之前的开源版本，也是该项目最早的版本，不含登录、支付等额外功能，便于克隆、部署和自由试验。它通过 Next.js API 路由把用户上传的房间照片送入托管在 Replicate 上的 ControlNet 机器学习模型，生成房间的多种变体效果，并使用 Bytescale 做图片存储。
社区作者 · zZz
它解决什么问题
RoomGPT 是 RoomGPT.io（付费 SaaS 产品）此前的开源版本，也是 RoomGPT 的第一个版本，去掉了登录鉴权、支付和其他附加功能，因此非常简单，适合克隆、部署和随意修改试验。
工作原理：项目使用名为 ControlNet 的机器学习模型来生成房间的各种变体。应用允许你上传任意房间的照片，照片会经由 Next.js 的 API 路由发送给该模型，随后返回为你生成的房间效果图。该机器学习模型托管在 Replicate 上，图片存储使用 Bytescale。
界面与效果可参考仓库中的截图（配图 2）。项目支持一键部署到 Vercel（配图 1）。
适用对象：想快速体验「AI 改造房间」效果的普通用户，以及希望学习 Next.js API 路由与 Replicate 第三方模型服务集成方式的开发者；也可作为自托管替代付费 SaaS 的基础起点。
注意：仓库未说明模型的具体参数规模、权重文件大小与最低硬件配置，这些信息待核验。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
本地运行步骤（按来源顺序）：
- 准备环境：本地机器需具备 git 与 Node.js/npm 环境（npm 命令用于安装依赖与启动应用）。
- 克隆仓库到本地：
git clone https://github.com/Nutlope/roomGPT- 注册 Replicate 账号以获取 API Key：
- 前往 Replicate 注册账号；
- 点击左上角的头像，再点击「API Tokens」；
- 在这里可以看到你的 API token，复制它。
- 把 API Key 写入 .env：在项目根目录创建一个环境变量文件（.env），按 .example.env 文件的示例写入你的 API Key。
- （可选）限流配置：如果你还想做限流（rate limiting），需要注册 UpStash 账号、创建一个 Redis 数据库，并在 .env 中填入对应的两个环境变量；如果不需要限流，则无需做任何改动。
- 安装依赖：
npm install- 启动应用：
npm run dev启动后应用可通过 http://localhost:3000 访问。
一键部署：可使用 Vercel 部署该示例（仓库中提供 Vercel 部署按钮，见配图 1）。
常见问题：未配置 .env 中的 Replicate API Key 时，上传照片后的模型调用无法正常工作；不做限流配置不影响功能使用，仅缺少频率限制能力。
