Skip to content

visualbruno/3DGenStudio

Repository files navigation

🌌 3D Gen Studio

The open-source AI-powered 3D mesh production layer.

Website PRs Welcome Discord

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.

WebsiteReport BugDiscord


📋 Changelog

Date Description
2026-07-04 Projects can be exported/imported
DB has been restructured and simplified
SetupWizard: Added Sam3.1 Segmentation + Gen Mesh with Hy2.1
2026-07-03 Mesh Editor: Added Optimize mode
Setup Wizard: Added Boogu Image and Image Editor
Kanban: Added a Name field for Image Generation
Image Editor: Can choose a name for saved image
OpenAI: Added gpt-image-2 model
2026-07-01 Added a python server
Mesh Editor : Added experimental "Auto UV" and "Auto Retopo"
2026-06-28 Can navigate on different pages during a ComfyUI workflow execution
SetupWizard: Added Krea2 Turbo
Server can be configured on another machine/port
2026-06-24 Mesh Editor: Added Wireframe toggle
Workflows: Can be shared
Tripo AI: Updated to v3
Graph Page: Fixed name used to save a mesh from an API
Run.bat: Fixed slowness
2026-06-22 Can delete Mesh Versions in Assets page
Fixed "Seam Smoothing" in MeshEditor Projection
Added Flux2Klein 4B
2026-06-17 Added Info Icon in GraphPage: Last Parameters used
ComfyUI workflows are sorted by name everywhere
Fixed bug in MeshEditor when ComfyUI crashes
2026-06-16 Assets page: Can group by project and improved Workflows layout
Cleaned Projects page and added rename button
MeshEditor Projection: Drawing mask is asynchronous
2026-06-15 Can export mesh from MeshPreviewer and MeshEditor
Improved Projection in MeshEditor
Added/Updated example workflows
2026-06-12 MeshEditor - Projection : Can use a Mask
Textbox : Can use a ComfyUI workflow to generate a text
2026-06-09 Can drag and drop images directly from your computer into your project
Added "Set as default" checkbox for ComfyUI Workflows
Kanban page: Can add a mesh directly in Mesh Gen column
Generated mesh is now a child of parent mesh
2026-06-05 Refactored the code
Fixed MeshEditor
Added more workflows
2026-06-03 Mesh Editor - Projection Mode: GPU Processing and Improved seams
Image Editor: New ComfyUI mode in AI
Graph page: Text node can generate text with ComfyUI
Setup Wizard: Added Flux2Dev and Flux2Klein9B
2026-05-29 Added Setup Wizard
Added a Wiki
2026-05-23 Mesh Editor : Projection mode can sent Textured/Untextured view to ComfyUI
Fixed delete a project
2026-05-21 Fixed bugs
2026-05-20 Mesh Editor: New Projection mode
Renamed Boolean mode by Displace
2026-05-15 Mesh Editor: Fixed modifications applied between modes
2026-05-14 Mesh Editor: Added new Boolean mode
2026-05-07 Image Editor: Added an experimental Shadow Remover
Image Editor: Can draw and erase the Base Layer
Notifications: Display errors in notifications panel
Graph Page: Can drag output connector to the workflow
2026-05-05 Can generate Mesh using Tripo AI and Tencent Cloud
Image Editor : Added Zoom-In/Out feature
2026-05-04 New Image Editor
2026-05-03 Support of abr file (Adobe Brush)
Improved performances in Graph mode
Fixed bugs in Mesh Editor with the brushes
2026-05-02 Added "Sculpting" mode in MeshEditor
Implemented "Search Assets"
Improved Modeling mode in Mesh Editor
2026-04-30 Painting mode: Added Layer selection
Can erase a layer using a brush
Fixed drawing on UV seams
2026-04-29 Added "Painting" mode in MeshEditor
2026-04-28 Added AssetSelector Dialog
MeshEditor: Added dropdowns for the inputs
Added real system metrics in the footer
Improved loading time in Mesh Editor
Fixed parent in Graph mode
2026-04-27 Improved Inpainting in Mesh Editor
2026-04-25 Improved the details of Inpainting in Mesh Editor
2026-04-24 Added Inpainting function in Mesh Editor
Added ComfyUI workflow examples
2026-04-21 Added Graph Node "Image Compare"
Improved a bit the "Mesh Editor" (not good yet)
2026-04-19 Improve the way to import ComfyUI workflows
Added a draft version of Mesh Editor
Added Change Log in Projects page
2026-04-19 First release

✨ Features

Switch between Kanban and Graph views to manage and visualize your entire 3D production pipeline in the way that suits your style.

📋 Kanban Board

Manage your 3D assets as cards flowing through automated pipeline stages — ImagesImage EditMesh GenMesh EditTexturing.

  • 🗂️ Drag-and-drop cards between pipeline stages
  • 🎠 In-card image carousel with variant browsing
  • Per-card ComfyUI & API action triggers
  • 🏷️ Custom attributes & metadata tagging

🕸️ Node Graph

Visualize the relationships between your assets as a node graph. Connect image sources to edit nodes, mesh generators, and export pipelines.

  • 👁️ Visual node-based asset relationships
  • 🔍 Click any node to open the inspector panel
  • 🎛️ ComfyUI workflow parameters inline
  • 🚀 Start workflows with one click

📚 Assets Library

A centralized library for all your images, meshes, and ComfyUI workflows. Browse, filter, and import assets directly into any project.

  • 📦 Unified view: Images, Meshes, Workflows
  • ⏱️ Version tracking per asset
  • 📥 One-click import into project
  • 📄 File format badges (PNG, GLB, OBJ, EXR)

🔌 Powerful Integrations

  • ComfyUI Native: Run any ComfyUI workflow directly from a card or node. Pass dynamic parameters, capture outputs, and chain results automatically.
  • External API Support: Integrate any REST or GraphQL API. Tag cards with API endpoints and trigger generation via any 3rd party 3D service.

💾 Local-First Storage

Projects are stored as locally on disk — Git-syncable, portable across machines, and strictly no cloud lock-in.


🚀 Workflow

Each stage feeds the next. Use ComfyUI workflows or external APIs at any step — the results automatically flow to the next card in your board!

  1. Create / Import an Image: Start with a text-to-image generation via ComfyUI, import an existing asset, or use an external API. Results land in the Images column.
  2. Edit & Refine: Apply image edits — inpainting, normal map generation, background removal. Cards automatically move to Image Edit.
  3. Generate 3D Mesh: Trigger a mesh generation workflow (e.g. TripoSR, Wonder3D). GLB/OBJ output moves the card to Mesh Gen.
  4. UV & Texture: Run automatic UV unwrapping and texture projection workflows. Layer multiple textures, apply normal maps, and preview results.
  5. Export & Publish: Export your finished mesh as GLB, OBJ, or EXR directly to your library. Track real-time status in the Action Log.

Mesh Editor

  1. Texturing: With ComfyUI, improve the details of your texture directly on the mesh or change it completely for your needs.
  2. Modeling: Basic features to edit the faces and vertices of your mesh, fix issues.
  3. Sculpting: Basic sculpting features (Standard, Clay, Inflate, Smooth, Flatten, Pinch, Grab).
  4. Painting: Paint directly on your mesh using brushes/images.
  5. Displace: Use a brush to displace the vertices with tessellation.
  6. Projection: With ComfyUI, project views on the mesh to get higher texture quality.

📸 Showcase

Kanban Dashboard
Kanban Dashboard
Assets Library
Assets Library 1 Assets Library 2
Mesh Preview / Viewer
Mesh Preview
Workflow / ComfyUI Integration
Workflow
MeshEditor / Inpainting
MeshEditor Inpainting

🛠️ Installation

Prerequisites

Before starting, make sure you have:

  • Node.js and npm installed
  • A running ComfyUI installation

Quick Start

# 1. Clone the repository
git clone https://github.com/visualbruno/3DGenStudio.git
cd 3DGenStudio

# 2. Install dependencies
npm install

# 3. Start the application
npm run dev

# 4. From another command line, configure and start python server in python-server folder
cd python-server
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python main.py

Note

This starts the backend server on http://localhost:3001 and the Vite frontend development server.

Configuration

Open the application and configure your services in the settings area:

  • ComfyUI path / host / port
  • External API credentials
  • Optional custom endpoints

💻 Tech Stack

Domain Technologies
Frontend React, Vite, React Router, Three.js, @react-three/fiber, @react-three/drei
Backend Node.js, Express, Multer
Data & Storage SQLite, LowDB, Local Asset Storage
Integrations ComfyUI, External AI APIs, REST/GraphQL

Documentation

You will find some documentation here: https://github.com/visualbruno/3DGenStudio/tree/main/docs


🤝 Contributing & Support

Have a question or an idea? Whether you want to report a bug, suggest a feature, or just say hello:

Support the Project!

Buy Me A Coffee


Privacy PolicyTerms of Service

About

No description, website, or topics provided.

Resources

License

Stars

254 stars

Watchers

6 watching

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors