Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

425 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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-31 Desktop App: Install ComfyUI
ImageEditor: Fixed alpha transparency
MultiView support with Trellis2
2026-07-28 Fixed Desktop App on Linux
ComfyUI: Added Enums
Wireframe mode in Mesh Previewer
2026-07-27 ComfyUI: Custom models folder
Mesh Export: Save last output folder
DB: Fixed assets linked to a project
Kanban: Can add more meshes and images from any column
Desktop App: Fixed Graph page slowness
2026-07-23 Added Brainstorming Boards
2026-07-20 MCP Server
Graph Page: Added Reorganize button
Graph Page: Save the last position and zoom level
Graph Page: Simplified Image Node Actions
Desktop App: Fixed Wiki
Desktop App: Auto-start python services in Settings
3D Mesh: Thumbnail is now generated by mesh-tools (python)
2026-07-16 Mesh Preview: FBX Export (Unity, Unreal Engine)
Graph Page: Can import a mesh directly from the computer
Kanban board: Added Rigging column
2026-07-15 MeshEditor: Auto Rig with Skintokens
Fixed Desktop App Setup
2026-07-10 Desktop App Installer
Speed up Auto Retopo
Added Clean Non-Manifold Edges in Auto Retopo
2026-07-08 Added Hitem3D API v1
2026-07-07 Fixed slowness when queuing multiple ComfyUI workflows
SetupWizard: Added Gen Mesh with Hy2.0
MeshEditor - Projection: Fixed Blend overlap seams with original texture
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.
  7. Auto UV: Automatically unwrap your mesh to generate clean UV coordinates.
  8. Auto Retopo: Automatically retopologize your mesh for a cleaner, optimized topology (with non-manifold edge cleanup).
  9. Auto Rig: Automatically generate a skeleton and skin weights for your mesh using AI.

📸 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.

First launch on macOS

Important

macOS builds are Apple Silicon only (M1 and later). Intel Macs are not supported: the Mesh Tools service needs Blender's bpy module, which no longer ships for macOS Intel.

The desktop app is ad-hoc signed but not yet notarized by Apple, so macOS blocks the first launch with:

Apple could not verify "3D Gen Studio" is free of malware that may harm your Mac or compromise your privacy.

This is Gatekeeper's standard warning for an app from outside the App Store, not a problem with the download. To allow it:

  1. Click Done on the dialog.
  2. Open System Settings → Privacy & Security.
  3. Scroll to the security section — "3D Gen Studio was blocked to protect your Mac" — and click Open Anyway.
  4. Authenticate, then confirm Open Anyway once more.

macOS remembers the decision; later launches open normally. On macOS 15 and later, Control-click → Open no longer works for this — System Settings is the only route.

Equivalent one-liner, if you prefer the terminal:

xattr -dr com.apple.quarantine "/Applications/3D Gen Studio.app"

Note

If macOS instead says the app "is damaged and can't be opened", that is a different (and fixed) problem — see docs/DESKTOP_BUILD.md.

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

A complete Wiki is included with the application.


🙏 Acknowledgments

3D Gen Studio builds on the great work of the open-source community. Special thanks to:

  • SkinTokens — used in Auto Rig for AI-powered skeleton generation and skinning.
  • mesh2motion-app — used in Auto Rig for skeleton/animation reference.
  • excalidraw — used for Brainstorming Boards.

🤝 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

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.

Resources

Stars

472 stars

Watchers

10 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages