ComfyUI-MeshFlow

ComfyUI-MeshFlow

A ComfyUI custom node wrapper for Meta's MeshFlow pipeline, providing state-of-the-art artist-like mesh remeshing directly within ComfyUI.

This node allows you to remesh 3D models to a clean, well-distributed vertex structure, optionally conditioned on a reference image. It interfaces seamlessly with the TRIMESH type used by standard 3D custom nodes (such as ComfyUI-PhantyForge).

---

Tribute & Credits

This project is a wrapper around the research and official implementation of:

MeshFlow: A Diffusion Model for Artist-Like Mesh Generation
Facebook Research (Meta)
Paper | Official Codebase

We give our deepest thanks and tribute to the original creators and authors at Meta for open-sourcing this incredible model and making high-quality, artist-like mesh diffusion generation accessible to the community.

---

Features

• Mesh Remeshing: Transforms irregular input geometry into a clean, uniform vertex layout.
• Vertex Control: Choose between the standard meshflow model and the meshflow_w_num_verts_control model to dynamically control target vertex counts.
• Image Conditioning: Guide the mesh generation using a reference image (automatically handled via DINOv3 visual encoder).
• Hole Filling: Triangulates and closes open boundaries automatically for clean output topology.
• Offline Mode: Supports pre-downloaded local weights for both MeshFlow and DINOv3 to run completely offline.

---

Model Setup

Before using the node, you need to place the model files in the appropriate directories.

1. MeshFlow Weights

Place the checkpoints under your ComfyUI models directory as follows:

ComfyUI/models/facebook/meshflow/
├── meshflow/
│   ├── config.yaml
│   └── model.pth
└── meshflow_w_num_verts_control/
    ├── config.yaml
    └── model.pth

2. DINOv3 Weights (Offline Support)

To run the DINOv3 visual encoder offline without requesting Meta's CDN, place the Vit-L/16 model weights file dinov3_vitl16_pretrain_lvd1689m-8aa4cbdd.pth here:

ComfyUI/models/facebook/dinov3-vitl16-pretrain-lvd1689m/
└── dinov3_vitl16_pretrain_lvd1689m-8aa4cbdd.pth

---

Node Configuration

Inputs

| Parameter | Type | Description | | :--- | :--- | :--- | | trimesh | TRIMESH | The input 3D model (Trimesh / Scene) to be remeshed. | | model_name | COMBO | Choose between meshflow (standard 4096 vertices) and meshflow_w_num_verts_control (dynamic vertex counts). | | steps | INT | Number of diffusion sampling steps (Default: 28). | | guidance_scale | FLOAT | CFG scale for image conditioning (Only active if reference_image is connected). | | seed | INT | Random seed for sampling latents. | | base_num_verts | COMBO | The base resolution/point count of the loaded model checkpoint (1024, 2048, 4096, 8192, or 16384). | | points | INT | Target vertex resolution of the generated output mesh (1024 to 16384). Only active with the meshflow_w_num_verts_control model. | | image_size | COMBO | Resolution to resize and center crop the reference image to (512, 1024, or 2048). | | device | COMBO | Execution device: cuda or cpu. | | dtype | COMBO | Computation precision: fp16, bf16, or fp32. | | compile | BOOLEAN | Uses torch.compile on CUDA for faster inference speeds. | | use_rmbg | BOOLEAN | Enables automatic background removal and foreground cropping for the reference image. | | fill_holes | BOOLEAN | Closes and triangulates boundary loops in the final output mesh. | | reference_image | IMAGE (Optional) | Optional reference image to guide generation. |

Outputs

| Name | Type | Description | | :--- | :--- | :--- | | trimesh | TRIMESH | The clean, remeshed output mesh. |