# mrforexample/comfyui-3d-pack architecture

> Architecture diagram of the GitHub repository mrforexample/comfyui-3d-pack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mrforexample/comfyui-3d-pack
- Repository: https://github.com/mrforexample/comfyui-3d-pack

## Overview

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`](https://github.com/mrforexample/comfyui-3d-pack/blob/main/nodes.py) (Custom Nodes), [`Gen_3D_Modules/PartCrafter/partcrafter_src/pipelines/pipeline_partcrafter.py`](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/PartCrafter/partcrafter_src/pipelines/pipeline_partcrafter.py) (PartCrafter), [`Gen_3D_Modules/Stable3DGen/stablex/pipeline_yoso.py`](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Stable3DGen/stablex/pipeline_yoso.py) (Stable3DGen), [`Gen_3D_Modules/Stable3DGen/trellis/pipelines/trellis_image_to_3d.py`](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Stable3DGen/trellis/pipelines/trellis_image_to_3d.py) (TRELLIS)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_comfy["ComfyUI Interface"]
  node_nodes["Custom Nodes<br/>[nodes.py]"]
  node_meshops["Mesh Processing<br/>[mesh.py]"]
end

subgraph group_generation["3D Generation"]
  node_partcrafter["PartCrafter"]
  node_hyshape["Hunyuan Shape<br/>[pipelines.py]"]
  node_stable3d["Stable3DGen<br/>[pipeline_yoso.py]"]
  node_triposg["TripoSG"]
  node_trellis["TRELLIS"]
  node_hunyuanv2["Hunyuan3D V2<br/>[pipelines.py]"]
end

subgraph group_multiview["Multiview Generation"]
  node_hunyuanv1["Hunyuan3D V1"]
  node_mvadapter["MV-Adapter"]
  node_wonder3d["Wonder3D"]
end

subgraph group_texturing["Mesh Texturing"]
  node_hunyuanpaint["Hunyuan Paint"]
  node_hyv2paint["Hunyuan V2 Paint<br/>[pipelines.py]"]
  node_mvtexture["MV-Adapter Texture"]
end

node_user(("Workflow User"))
node_asset["3D Asset"]

node_user -.->|"submits workflow"| node_nodes
node_nodes -.->|"dispatches"| node_partcrafter
node_nodes -.->|"dispatches"| node_hyshape
node_nodes -.->|"dispatches"| node_stable3d
node_nodes -.->|"dispatches"| node_triposg
node_nodes -.->|"dispatches"| node_trellis
node_nodes -.->|"dispatches"| node_hunyuanv2
node_nodes -.->|"dispatches"| node_hunyuanv1
node_nodes -.->|"dispatches"| node_mvadapter
node_nodes -.->|"dispatches"| node_wonder3d
node_nodes -.->|"dispatches"| node_hunyuanpaint
node_nodes -.->|"dispatches"| node_hyv2paint
node_nodes -.->|"dispatches"| node_mvtexture
node_partcrafter -->|"generates parts"| node_asset
node_hyshape -->|"generates shape"| node_asset
node_stable3d -->|"generates mesh"| node_asset
node_triposg -->|"generates mesh"| node_asset
node_trellis -->|"generates textured mesh"| node_asset
node_hunyuanv2 -->|"generates mesh"| node_asset
node_hunyuanv1 -->|"reconstructs mesh"| node_asset
node_mvadapter -->|"generates views"| node_asset
node_wonder3d -.->|"generates views"| node_asset
node_hunyuanpaint -->|"textures mesh"| node_asset
node_hyv2paint -->|"textures mesh"| node_asset
node_mvtexture -->|"textures mesh"| node_asset
node_stable3d -->|"built by"| node_trellis
node_partcrafter -.->|"mesh output"| node_meshops
node_asset -.->|"processed by"| node_meshops

click node_nodes "https://github.com/mrforexample/comfyui-3d-pack/blob/main/nodes.py"
click node_meshops "https://github.com/mrforexample/comfyui-3d-pack/blob/main/mesh_processer/mesh.py"
click node_partcrafter "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/PartCrafter/partcrafter_src/pipelines/pipeline_partcrafter.py"
click node_hyshape "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_2_1/hy3dshape/hy3dshape/pipelines.py"
click node_stable3d "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Stable3DGen/stablex/pipeline_yoso.py"
click node_triposg "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/TripoSG/pipelines/pipeline_triposg.py"
click node_trellis "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Stable3DGen/trellis/pipelines/trellis_image_to_3d.py"
click node_hunyuanv2 "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/shapegen/pipelines.py"
click node_hunyuanv1 "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_V1/mvd/hunyuan3d_mvd_std_pipeline.py"
click node_mvadapter "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_mvadapter_i2mv_sdxl.py"
click node_wonder3d "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Wonder3D/pipelines/pipeline_mvdiffusion_image.py"
click node_hunyuanpaint "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_2_1/hy3dpaint/textureGenPipeline.py"
click node_hyv2paint "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/texgen/pipelines.py"
click node_mvtexture "https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_texture.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_nodes,node_meshops,node_user toneBlue
class node_partcrafter,node_hyshape,node_stable3d,node_triposg,node_trellis,node_hunyuanv2 toneAmber
class node_hunyuanv1,node_mvadapter,node_wonder3d toneMint
class node_hunyuanpaint,node_hyv2paint,node_mvtexture toneRose
class node_asset toneIndigo
```

## Components

### ComfyUI Interface

- [Custom Nodes](https://github.com/mrforexample/comfyui-3d-pack/blob/main/nodes.py): `nodes.py`
- [Mesh Processing](https://github.com/mrforexample/comfyui-3d-pack/blob/main/mesh_processer/mesh.py): `mesh_processer/mesh.py`

### 3D Generation

- [PartCrafter](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/PartCrafter/partcrafter_src/pipelines/pipeline_partcrafter.py): `Gen_3D_Modules/PartCrafter/partcrafter_src/pipelines/pipeline_partcrafter.py`
- [Hunyuan Shape](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_2_1/hy3dshape/hy3dshape/pipelines.py): `Gen_3D_Modules/Hunyuan3D_2_1/hy3dshape/hy3dshape/pipelines.py`
- [Stable3DGen](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Stable3DGen/stablex/pipeline_yoso.py): `Gen_3D_Modules/Stable3DGen/stablex/pipeline_yoso.py`
- [TripoSG](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/TripoSG/pipelines/pipeline_triposg.py): `Gen_3D_Modules/TripoSG/pipelines/pipeline_triposg.py`
- [TRELLIS](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Stable3DGen/trellis/pipelines/trellis_image_to_3d.py): `Gen_3D_Modules/Stable3DGen/trellis/pipelines/trellis_image_to_3d.py`
- [Hunyuan3D V2](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/shapegen/pipelines.py): `Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/shapegen/pipelines.py`

### Multiview Generation

- [Hunyuan3D V1](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_V1/mvd/hunyuan3d_mvd_std_pipeline.py): `Gen_3D_Modules/Hunyuan3D_V1/mvd/hunyuan3d_mvd_std_pipeline.py`
- [MV-Adapter](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_mvadapter_i2mv_sdxl.py): `Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_mvadapter_i2mv_sdxl.py`
- [Wonder3D](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Wonder3D/pipelines/pipeline_mvdiffusion_image.py): `Gen_3D_Modules/Wonder3D/pipelines/pipeline_mvdiffusion_image.py`

### Mesh Texturing

- [Hunyuan Paint](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_2_1/hy3dpaint/textureGenPipeline.py): `Gen_3D_Modules/Hunyuan3D_2_1/hy3dpaint/textureGenPipeline.py`
- [Hunyuan V2 Paint](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/texgen/pipelines.py): `Gen_3D_Modules/Hunyuan3D_V2/hy3dgen/texgen/pipelines.py`
- [MV-Adapter Texture](https://github.com/mrforexample/comfyui-3d-pack/blob/main/Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_texture.py): `Gen_3D_Modules/MV_Adapter/mvadapter/pipelines/pipeline_texture.py`

### Other components

- **Workflow User**
- **3D Asset**

## Connections

- 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 (evidence: `README.md`)
- Hunyuan Shape → 3D Asset: generates shape (evidence: `README.md`)
- Stable3DGen → 3D Asset: generates mesh (evidence: `README.md`)
- TripoSG → 3D Asset: generates mesh (evidence: `README.md`)
- TRELLIS → 3D Asset: generates textured mesh (evidence: `README.md`)
- Hunyuan3D V2 → 3D Asset: generates mesh (evidence: `README.md`)
- Hunyuan3D V1 → 3D Asset: reconstructs mesh (evidence: `README.md`)
- MV-Adapter → 3D Asset: generates views (evidence: `README.md`)
- Wonder3D → 3D Asset: generates views
- Hunyuan Paint → 3D Asset: textures mesh (evidence: `Gen_3D_Modules/Hunyuan3D_2_1/hy3dpaint/textureGenPipeline.py`)
- Hunyuan V2 Paint → 3D Asset: textures mesh (evidence: `README.md`)
- MV-Adapter Texture → 3D Asset: textures mesh (evidence: `README.md`)
- Stable3DGen → TRELLIS: built by (evidence: `Gen_3D_Modules/Stable3DGen/pipeline_builders.py`)
- PartCrafter → Mesh Processing: mesh output
- 3D Asset → Mesh Processing: processed by
