How mrforexample/comfyui-3d-pack works
ComfyUI-3D-Pack is a ComfyUI custom-node suite for generating and processing 3D assets with multiple model families. The principal workflow is to supply an image, prompt, or existing mesh to a ComfyUI node, run a selected generation or multiview stage, optionally texture the resulting mesh, and return mesh or image outputs. The README documents substantial model branches beyond the sampled source; those are represented at their existing subsystem paths, with unverified runtime dispatch shown as dashed. Source excerpts are limited, so most branch connections reflect documented capabilities rather than inspected node wiring.
Main entry points: nodes.py Custom Nodes · pipeline_partcrafter.py PartCrafter · pipeline_yoso.py Stable3DGen · trellis_image_to_3d.py TRELLIS
Components 16
ComfyUI Interface
- Custom Nodes
nodes.py - Mesh Processing
mesh_processer/mesh.py
3D Generation
- PartCrafter
Gen_3D_Modules/PartCrafter/partcrafter_src/pipelines/pipeline_partcrafter.py - Hunyuan Shape
Gen_3D_Modules/Hunyuan3D_2_1/hy3dshape/hy3dshape/pipelines.py - Stable3DGen
Gen_3D_Modules/Stable3DGen/stablex/pipeline_yoso.py - TripoSG
Gen_3D_Modules/TripoSG/pipelines/pipeline_triposg.py - TRELLIS
Gen_3D_Modules/Stable3DGen/trellis/pipelines/trellis_image_to_3d.py - Hunyuan3D V2
Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/shapegen/pipelines.py
Multiview Generation
- Hunyuan3D V1
Gen_3D_Modules/Hunyuan3D_V1/mvd/hunyuan3d_mvd_std_pipeline.py - MV-Adapter
Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_mvadapter_i2mv_sdxl.py - Wonder3D
Gen_3D_Modules/Wonder3D/pipelines/pipeline_mvdiffusion_image.py
Mesh Texturing
- Hunyuan Paint
Gen_3D_Modules/Hunyuan3D_2_1/hy3dpaint/textureGenPipeline.py - Hunyuan V2 Paint
Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/texgen/pipelines.py - MV-Adapter Texture
Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_texture.py
Other components
- Workflow User
- 3D Asset
Connections 28
- Workflow User → Custom Nodes: submits workflow
- Custom Nodes → PartCrafter: dispatches
- Custom Nodes → Hunyuan Shape: dispatches
- Custom Nodes → Stable3DGen: dispatches
- Custom Nodes → TripoSG: dispatches
- Custom Nodes → TRELLIS: dispatches
- Custom Nodes → Hunyuan3D V2: dispatches
- Custom Nodes → Hunyuan3D V1: dispatches
- Custom Nodes → MV-Adapter: dispatches
- Custom Nodes → Wonder3D: dispatches
- Custom Nodes → Hunyuan Paint: dispatches
- Custom Nodes → Hunyuan V2 Paint: dispatches
- Custom Nodes → MV-Adapter Texture: dispatches
- PartCrafter → 3D Asset: generates parts
README.md - Hunyuan Shape → 3D Asset: generates shape
README.md - Stable3DGen → 3D Asset: generates mesh
README.md - TripoSG → 3D Asset: generates mesh
README.md - TRELLIS → 3D Asset: generates textured mesh
README.md - Hunyuan3D V2 → 3D Asset: generates mesh
README.md - Hunyuan3D V1 → 3D Asset: reconstructs mesh
README.md - MV-Adapter → 3D Asset: generates views
README.md - Wonder3D → 3D Asset: generates views
- Hunyuan Paint → 3D Asset: textures mesh
Gen_3D_Modules/Hunyuan3D_2_1/hy3dpaint/textureGenPipeline.py - Hunyuan V2 Paint → 3D Asset: textures mesh
README.md - MV-Adapter Texture → 3D Asset: textures mesh
README.md - Stable3DGen → TRELLIS: built by
Gen_3D_Modules/Stable3DGen/pipeline_builders.py - PartCrafter → Mesh Processing: mesh output
- 3D Asset → Mesh Processing: processed by