Vibe3DScene Vibe 项目

项目简介

Vibe3DScene 是一个连接 AI Agent 与 Blender 的开源 3D 场景生成工具，属于典型的 Vibe Coding 理念产物——用户用自然语言描述想要的 3D 场景，AI 驱动 Blender 自动完成建模、渲染和场景构建。该项目由模块化的 LangGraph 运行时驱动，通过 MCP（Model Context Protocol）工具层统一调度场景控制、渲染、检索、重建和 3D 生成能力，实现"说一句话，AI 替你操控 Blender"的体验。

核心功能

• 自然语言驱动的 3D 场景生成：用户输入文字描述，AI 自动在 Blender 中创建相应几何体、材质和光照
• 多模式 Agent 运行时：支持 direct_mode（直接执行）和 plan_mode（规划后执行），可切换 fast_mode 加速验证
• 双 Agent 拓扑（实验性）：支持 evaluator-agent 架构，由主 agent 执行、评估 agent 校验，形成闭环
• Blender 无头模式：API 可在无图形界面的服务器环境中驱动 Blender，支持 Docker 部署
• MCP 统一工具层：场景控制、渲染管理、3D 检索、物体重建等工具统一封装，按需调用
• Redis 会话持久化：检查点机制支持单 worker 和多 worker 部署，场景状态不丢失
• Web UI + CLI + Blender 客户端：三种交互方式，满足不同工作流需求

技术实现

Vibe3DScene 的技术架构分为五层：

接入层：Web UI（React + TypeScript + Vite）、命令行工具（Python）、本地 Blender 客户端插件，均通过 REST API 与后端通信。

路由层（Router）：基于 LangGraph 的请求路由器，根据模式选择 direct_mode、plan_mode 或 dual-agent 拓扑，管理 todo 列表，显式追踪任务状态。

工具层（MCP）：MCP Server 封装了所有对外工具的调用，包括 Blender 场景控制、渲染管理、图像检索、3D 重建等能力，支持工具门控（tool gating）和模式约束。

执行层（Blender）：通过 Socket 或无头会话与 Blender 通信，支持在 Linux/macOS 服务器上运行完整渲染管线，不依赖图形桌面。

外部工具服务：可选的 3DAgentTools 工具栈以 Docker 容器独立部署，解耦于核心运行时，可按需扩展。

会话状态由 Redis 持久化保存，支持多 worker 并发和断点续传。

快速上手

1. 克隆仓库并安装依赖

git clone --recurse-submodules https://github.com/3DSceneAgent/Vibe3DScene
cd Vibe3DScene
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# 填写 provider keys 和运行时配置

2. 启动后端服务（两种模式）

无头模式（纯 API）：

./scripts/run_headless.sh

本地 Blender 客户端模式：

./scripts/run_local_client.sh

3. 启动前端 Web UI

cd web && npm install && npm run dev
# 浏览器打开 http://localhost:3000，指向 http://localhost:8000

4. 体验自然语言生成 3D 场景

在 Web UI 输入自然语言描述（如"创建一个蓝色立方体和一个红色球体"），AI 自动生成 Blender 场景脚本并执行渲染。

5. 可选：启用穿透校验

export SCENE_AGENT_ENABLE_PENETRATION_VERIFY=true

适用人群

• 3D 设计师和艺术家：无需编写脚本，用自然语言快速生成概念场景
• AI 研究者：研究 Agent 与专业软件（Blender）的工具调用、规划与验证能力
• 游戏和元宇宙开发者：批量生成场景资产，探索 AI 原生的 3D 内容生产流程
• Vibe Coding 爱好者：体验"用嘴编程"在 3D 创作领域的落地

官方链接

• GitHub 仓库：https://github.com/3DSceneAgent/Vibe3DScene
• 在线演示：https://vibe3dscene.vercel.app
• 视频演示：https://youtu.be/rnZelKViTbk