Hunyuan 3D 2.1 Load Mesh

The full Hunyuan3D pipeline is heavy - a 7B diffusion model just to get a mesh. But you don't always need to generate the geometry. Sometimes you already have a mesh: a low-poly asset you want re-textured, a scan, something a friend sent you. Hy3D21LoadMesh is the node that pulls a .glb off disk and hands it to the rest of the pack as a TRIMESH, so you can skip straight to the fun part - UV wrap, paint, bake, export.

It's the foundation of the Mesh_Texturing workflows in the example folder, which go: Hy3D21LoadMesh → Hy3D21MeshUVWrap → Hy3DMultiViewsGenerator → Hy3DBakeMultiViews → Hy3DInPaint. No shape generation, no VAE decode, no 7B model in VRAM. If your only goal is texture, this is the cheap path.

The input

A single glb_path string. The tooltip says "The glb path with mesh to load." It accepts either an absolute path (C:/models/mything.glb or /home/you/models/mything.glb) or a path relative to your ComfyUI input folder - the node checks the absolute path first, then falls back to models-style resolution against the input directory. The output is the loaded trimesh, described as "The glb model with mesh to texturize."

One detail worth knowing: it uses Trimesh.load(..., force="mesh"), so if your glb contains multiple nodes or a hierarchy, you get the merged triangle mesh, not the scene graph. That's what you want for texturing.

How it works

Two lines of logic, honestly: check the path, load it with trimesh. No models, no GPU, runs instantly. It's the sibling of Hy3D21ExportMesh (which writes glbs) - this one reads them.

Installing and using it

Ships with the pack; nothing beyond the base install and trimesh is required.

cd ComfyUI/custom_nodes
git clone https://github.com/visualbruno/ComfyUI-Hunyuan3d-2-1
cd ComfyUI-Hunyuan3d-2-1
pip install -r requirements.txt

Common issues

The most common failure is a wrong path - a path typo yields a trimesh load error, and the node doesn't give you a friendly "file not found" message. If you're unsure, drop the file in your ComfyUI input/ folder and use just the filename, which sidesteps path games entirely. Second gotcha: the mesh you load gets texture-mapped by the pipeline, but if the original glb already has its own UVs and you don't run it through Hy3D21MeshUVWrap, the bake will fight the existing layout. Unwrap after loading, always. And remember this node expects a glb - if your source is an .obj or .fbx, convert it first (Blender's a one-click fix).