visualbruno/3DGenStudio

Orchestrate complete 3D generation pipelines — from text-to-image, image editing, mesh generation, UV unwrapping, to texturing — all in a single visual workspace powered by ComfyUI and external APIs.

🎨 什么是 3D Gen Studio？

3D Gen Studio 是一个开源桌面/网页应用程序，让您在单一视觉工作区中从文本提示一路构建完整的 3D 资产，直至生成游戏就绪的网格。它将 ComfyUI（基于节点的 AI 图像生成引擎）与若干外部 3D 生成 API 相结合，并添加了一整套网格编辑工具（UV 展开、重拓扑、绑定、纹理烘焙、LOD 等）。

核心理念是 管道 UI，可显示为 看板板（卡片在阶段间流动）或 节点图（资产通过箭头连接的节点）。每个卡片或节点可触发 ComfyUI 工作流或外部 REST/GraphQL API，结果会自动流入下一阶段。

🛠️ 主要功能（如 README 所述）

功能	说明
看板板	拖拽卡片通过各阶段：图像 → 图像编辑 → 网格生成 → 网格编辑 → 纹理。每个卡片可存储自定义元数据，并启动 ComfyUI 工作流或 API 调用。
节点图视图	资产的可视化图谱；点击节点可编辑参数、运行关联的 ComfyUI 工作流或查看网格预览。
资产库	图像、网格（GLB/OBJ/FBX）和 ComfyUI 工作流文件的集中视图。支持版本控制、格式徽章和一键导入任意项目。
ComfyUI 集成	本地运行任意 ComfyUI 工作流；参数可内联编辑，输出自动作为新资产捕获。
外部 API 支持	任何 REST/GraphQL 3D 服务（如 TripoSR、Wonder3D、Kimodo）均可从卡片或节点调用。
本地优先存储	项目保存在磁盘（SQLite/LowDB），支持 Git 同步，无云锁定，可移植性强。
网格编辑器	应用内工具支持：

纹理（将纹理投影到网格）
基础建模（面/顶点编辑）
雕刻（标准画笔）
直接在网格上绘画
通过画笔驱动的细分实现位移
使用 ComfyUI 投影纹理
自动 UV 展开、自动重拓扑、自动绑定（AI 驱动的骨骼/权重，通过 SkinTokens 与 Kimodo）
优化/LOD 生成、碰撞体创建
法线/AO/位置贴图烘焙
游戏就绪检查（三角形预算、UV 接缝、比例、轴心） | | 批量项目 | 定义一系列自动运行的阶段；支持图像、网格和布尔类型，并可导出资产列表。 | | 多用户 / 局域网 | 服务器可部署在另一台机器；桌面应用可通过局域网或反向代理连接。 | | 跨平台桌面应用 | 使用 Electron/Node 构建，支持 Windows、macOS（仅 Apple Silicon）、Linux。 | | 详尽的更新日志 | 频繁更新（每周多次），新增生成器、VFX 工具、树/组件生成器、动画集成（MoCapAnythingV2、Kimodo）及 UI 改进。 |

🚀 典型工作流

创建 / 导入图像 – 使用 ComfyUI 文本到图像模型或外部 API。
编辑图像 – 局部重绘、法线贴图生成、背景移除。
生成网格 – 从卡片调用 3D 生成服务（如 TripoSR）。
UV 与纹理 – 运行自动 UV、投影或纹理绘制步骤。
最终处理 – 烘焙贴图、创建 LOD、绑定网格，并导出为 GLB/OBJ/FBX。

所有步骤均可在看板板上以卡片流动或在图谱视图中以链接节点的形式可视化。

📦 安装（快速摘要）

前置条件：Node.js + npm，运行中的 ComfyUI 实例，后端服务器用 Python 3。
克隆仓库 → npm install → npm run dev 启动前端。
在 python-server 文件夹中：创建虚拟环境，pip install -r requirements.txt，然后 python main.py。
后端运行在 http://localhost:3001；Vite 开发服务器提供 UI。
macOS Apple-Silicon 构建需手动绕过 Gatekeeper（见 README）。

🧩 技术栈

前端：React、Vite、Three.js（@react-three/fiber、@react-three/drei）。
后端：Node/Express + Multer（文件上传）。
存储：SQLite + LowDB（资产元数据）。
AI 集成：ComfyUI（本地）+ 任意外部 AI/3D API。

🤝 社区与贡献

欢迎 PR（README 中有徽章）。
Discord 频道用于支持与功能讨论。
应用内捆绑 Wiki 提供详细文档。

📚 总结

3D Gen Studio 是一个真正活跃维护的开源项目，将 AI 驱动的图像生成、3D 网格创建和全套网格编辑工具整合为统一的视觉工作流。它面向艺术家、游戏开发者和研究人员，提供一个无需被云服务锁定的单一平台，用于原型化 AI 生成的 3D 资产。