Nodes/ComfyUI-ComfyUI-Hunyuan3DWrapper/Hy3D Instant-Meshes Remesh
ComfyUI Node

Hy3D Instant-Meshes Remesh

The retopology pass that gives your triangle soup actual structure

By kijai·Created 2 years ago·Updated 5 months ago· 1,033
Hy3D Instant-Meshes Remesh
  • trimesh
  • trimesh
merge_verticestrue
vertex_count10000
smooth_iter8
align_to_boundariestrue
triangulate_resulttrue
max_facenum40000

The single most consistent complaint about generated 3D is the geometry: Hunyuan3D hands you a mesh that looks great and has all the topological grace of a crumpled receipt. Hy3DIMRemesh is the pack's retopology tool. It runs instant-meshes (via pynanoinstantmeshes) over your mesh and rebuilds it as clean, regular geometry - a new triangle/quad grid that actually respects the surface's flow instead of the chaotic soup the VAE emitted.

This is the node to reach for when the destination is something that cares about topology: a game engine, a rig, or any deformation. For a 3D print it's overkill - printers don't care about triangle soup at all.

The tradeoff printed right in the description

The node's own description says it plainly: "this will remove all vertex colors and textures." Remeshing rebuilds the geometry from scratch, so any baked color or texture goes with it. In practice that's usually fine, because in the intended flow you remesh before texturing:

Hy3DVAEDecode → Hy3DIMRemesh → Hy3DMeshUVWrap → render → paint → bake

If you remesh after texturing, you lose the texture and have to repaint. Plan for remesh-first.

Inputs that matter

  • trimesh - the mesh to remesh.
  • vertex_count (default 10000) - the target vertex count for the new mesh. This sets the resolution of the result. 10k is a reasonable middle; drop it for low-poly, raise for detail.
  • merge_vertices (default true) - welds coincident vertices first, which is basically always what you want after a VAE decode (it produces duplicated vertices everywhere).
  • smooth_iter (default 8) - how many smoothing passes instant-meshes applies during the process. More smoothing = rounder, less faithful to sharp features.
  • align_to_boundaries (default true) - aligns the new mesh to the existing open boundaries, preserving the silhouette edge.
  • triangulate_result (default true) - converts the quad-heavy output to triangles. Instant-meshes likes producing quads; leave this on unless you want quads for some downstream reason.
  • max_facenum (default 40000) - if the remesh somehow comes back with more faces than this, a face-reduction pass trims it down.

Output: trimesh (TRIMESH).

Install note

Like Hy3DFastSimplifyMesh, this one needs a dependency the pack doesn't bundle: pynanoinstantmeshes. If it's missing you'll get an explicit ImportError pointing you to pip install pynanoinstantmeshes (it's also listed in the pack's requirements_extras.txt). The base pack install gets you everything else (ComfyUI Manager, search "Hunyuan3DWrapper", or clone into custom_nodes and pip install -r requirements.txt).

One honest framing: instant-meshes gives you clean, regular topology - but it's automatic topology. It's a huge improvement over VAE soup for deformation, and it is not the hand-made retopology a professional does for an animation hero asset. It's "good enough to rig without screaming," which is genuinely where the field is at.

CategoryHunyuan3DWrapper

Inputs (7)

NameTypeDefaultDescription
trimeshTRIMESH
merge_verticesBOOLEANtrue
vertex_countINT10000100–10000000
smooth_iterINT80–100
align_to_boundariesBOOLEANtrue
triangulate_resultBOOLEANtrue
max_facenumINT400001–10000000

Outputs (1)

NameTypeDescription
trimeshTRIMESH