hunyuan-3d-v21

Generates 3D meshes with PBR textures from single images using Hunyuan3D 2.1 in ComfyUI.

Updated Jul 18, 2026
One-click install
npx skills add https://github.com/devlitus/space-flight---combat-simulator --skill hunyuan-3d-v21-devlitus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hunyuan-3d-v21
Source: https://github.com/devlitus/space-flight---combat-simulator/tree/main/.codex/skills/hunyuan-3d-v21
Command: npx skills add https://github.com/devlitus/space-flight---combat-simulator --skill hunyuan-3d-v21-devlitus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Converting a single 2D image into a usable 3D asset with shape and PBR textures is error-prone: bad input images produce melted geometry, VRAM limits cause out-of-memory failures, and misconfigured shape or paint parameters waste hours of GPU time. This Skill codifies proven recipes for running Tencent Hunyuan3D 2.1 inside ComfyUI so each generation succeeds on the first queue. ## Core Features & Use Cases - Input image preparation rules: guidance on centered single objects, transparent backgrounds via rembg, and silhouette quality that determines most of the output quality. - VRAM recipes for 12GB GPUs: concrete parameter sets for shape (~10GB) and texture painting (low_vram_mode, texture_size 1024, view_size 512) on cards like the RTX 4070, plus OOM troubleshooting steps. - Shape and PBR parameter tables: steps, guidance_scale, octree_resolution, max_num_view, and texture_size with recommended ranges for preview versus production quality. - Export and QA workflows: GLB/OBJ/STL export guidance, Blender-based headless QA rendering, and a CPU-only vertex-color fallback when full PBR is not viable. - Use Case: A game artist uploads a product photo of a prop, follows the checklist to generate a textured GLB on a 12GB GPU, then validates the mesh in Blender before importing it into the game engine. ## Quick Start Use the hunyuan-3d-v21 skill to turn my input image 'prop.png' into a textured 3D model for a game, running on a 12GB GPU.

Frequently Asked Questions about hunyuan-3d-v21

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a 3D model from a single image in ComfyUI?▼

Use Hunyuan3D 2.1 with the native ComfyUI chain: ImageOnlyCheckpointLoader, Hunyuan3Dv2Conditioning, KSampler, VAEDecodeHunyuan3D, VoxelToMesh, and SaveGLB. Prepare a centered single object with a clean or transparent background for best results.

How to run Hunyuan3D 2.1 texture painting on a 12GB GPU?▼

Texture painting needs about 21GB, so on 12GB enable low_vram_mode with texture_size 1024, view_size 512, max_num_view 6, and resolution 512. If baking still runs out of memory, lower texture_size first, then view_size.

What input images work best for image-to-3D generation?▼

Use one centered object with its full silhouette inside the frame on a plain or transparent background, preferably RGBA processed with rembg. Avoid text, watermarks, flat logos, thin line drawings, and crowded scenes, which cause melted backs and floating pieces.

Why does Hunyuan3D shape generation fail with CUDA out of memory?▼

Shape generation uses about 10GB, so OOM happens when other processes hold VRAM or settings are too high. Lower octree_resolution from 384 to 256, reduce steps from 50 to 25, increase num_chunks, close other apps, or enable low_vram_mode.

Can I get PBR textures without a 24GB GPU?▼

Full PBR painting requires about 21GB and the visualbruno wrapper with compiled custom_rasterizer wheels. A verified CPU fallback projects the photo onto the mesh as vertex colors and exports GLB with COLOR_0, giving a faithful front view for later retouching in Blender or Substance.

What are the limitations of AI-generated 3D meshes?▼

AI-generated meshes are a fast first pass, not final assets. Expect cleanup, retopology, scale adjustment, and texture editing, and always review the back, underside, seams, and floating pieces in a second tool like Blender before delivery.