【亲测免费】 《Vibe Draw项目安装与配置指南》

1. 项目基础介绍

Vibe Draw 是一个开源项目，可以将用户在二维画布上的草图转化为精美的三维模型。该项目旨在降低三维建模的门槛，让不具备专业艺术或技术能力的用户也能轻松创作三维世界。

项目主要使用的编程语言包括 TypeScript、CSS 和 Python。

2. 项目使用的关键技术和框架

• 前端技术：使用 Next.js 和 React 构建响应式、用户友好的界面。
• 三维渲染：采用 Three.js 渲染交互式三维模型。
• 二维绘图：使用 TLDraw 提供强大的二维绘图画布。
• 状态管理：使用 Zustand 进行状态管理。
• 后端技术：使用 FastAPI，这是一个高性能的 API 框架。
• 异步任务处理：使用 Celery，一个异步任务队列，用于 AI 操作。
• 实时更新：利用 Redis 的 Pub/Sub 功能进行实时更新和任务结果存储。
• 服务器发送事件：使用 SSE (Server-Sent Events) 实现实时进度更新。

3. 项目安装和配置的准备工作

在开始安装前，请确保您的系统中已安装以下软件：

• Node.js 18+ 版本
• Python 3.10+ 版本
• API 密钥（ Claude、Gemini、Cerebras 和 PiAPI）

3.1 前端安装步骤

1. 克隆或下载项目后，切换到项目的前端目录：

   cd frontend
   

2. 使用 npm 安装前端依赖：

   npm install
   

3. 运行开发服务器：

   npm run dev
   

3.2 后端安装步骤

1. 切换到项目的后端目录：

   cd backend
   

2. 将 .env.example 文件复制为 .env 并填写相应的 API 密钥：

   cp .env.example .env
   

3. 使用 Docker Compose 启动后端服务：

   docker compose up
   

按照以上步骤，您应该能够成功安装和配置 Vibe Draw 项目。祝您使用愉快！