comfy / hunyuan3D / texGen

Here's the workflow that makes image-to-3D actually usable: generate a shape cheap, then spend your real effort on the texture. The Hunyuan3D texGen node is the second half of that - it takes a mesh you already have and repaints it from a reference image, on Civitai's cloud, without a single local model file.

What it is

The comfy / hunyuan3D / texGen recipe in the civitai/civitai-comfy-nodes pack. Mechanically it's identical to its siblings: submit a job to the Civitai orchestration API, poll, get native Comfy outputs back. The difference is which fields it requires. Where imageTo3D just needs a picture, texGen wants two things:

• image_url - the reference image (IMAGE socket). This is what drives the paint stage; the texture is hallucinated from this picture's look.
• mesh - a CIVITAI_AIR input, not a file. You fill it by wiring a Civitai Model Selector node and picking the mesh (or by wiring the model output of a prior shapeGen/imageTo3D run if the pack lets you - the selector path is the reliable one).

So the natural loop is: shapeGen (or imageTo3D) makes the geometry → texGen reskins it. The mesh travels as an AIR reference, which means the whole thing stays cloud-side - you never download the GLB just to re-upload it.

The inputs

Beyond the two required ones, the schema is the Hunyuan3D diffusion panel again:

• model_version - v2, v2.1, v2-mini.
• enable_pbr - default true, and here it actually matters. PBR means the texture ships as metalness/roughness/albedo channels rather than a single baked diffuse map, so it relights properly in a game engine. Keep it on unless you have a reason not to.
• should_remesh - default off. Turn it on to let the pipeline rebuild geometry as part of the job; useful if your source mesh is rough.
• steps, cfg_scale, sampler, scheduler - the texture model's sampling knobs. Defaults are fine.
• prompt - a text hint for the paint stage, e.g. material descriptors ("rusty metal", "painted wood").

The outputs

model (URL to the textured GLB), fbx_model, thumbnail (IMAGE → wire into Preview Image), then the usual rigged/animated slots that mostly stay empty on Hunyuan3D, plus workflow_id and raw_json.

Installing it

Standard pack install - ComfyUI Manager, search Civitai Comfy Nodes, install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/civitai/civitai-comfy-nodes.git
pip install -r civitai-comfy-nodes/requirements.txt

No model downloads; requests + python-socketio are the only deps.

The gotchas

• Credentials or nothing. Wire a Civitai Auth node, set CIVITAI_API_TOKEN, or sign in via the sidebar. No token, no texture.
• The mesh input is the thing people fumble. It's not a file path - it's an AIR socket. If you don't see a place to type a path, that's because there isn't one. Use the Model Selector's Browse button.
• Metered, per run. Texture passes bill in Buzz; watch raw_json if you're running a lot of iterations.
• Texture quality ceiling. Hunyuan3D's PBR texturing is "furthest along" of the open pipes, but it's not production-grade. Expect to do cleanup for anything that ships.
• Organic shapes are the weak spot. Faces, animals, cloth reconstruct worse than hard-surface props across the whole model family. Budget accordingly.