What You'll Build
Convert any image into a high-quality 3D model locally using Hunyuan3D-2 from Tencent. Generate game-ready assets, product mockups, or character models from a single photo — entirely offline.
Why this matters: Cloud 3D generation services charge $0.10–$1.00 per asset. With a local setup, generate unlimited 3D assets for free.
What Hunyuan3D-2 Produces
- GLB format: Ready to import into Blender, Unity, Unreal Engine
- Textured mesh: UV-unwrapped with diffuse texture
- Generation time: 30–90 seconds per model on RTX 4090
Niche advantage: 3D generation has very little local tutorial content. See why this is strategic →
Requirements
| Component | Minimum | Recommended |
|---|---|---|
| GPU | RTX 4070 (12GB) | RTX 4090 (24GB) |
| VRAM | 12GB | 24GB |
| RAM | 16GB | 32GB |
| Storage | 20GB | 20GB |
| Software | Blender 4.0+ | Blender 4.2+ |
Installation
1. Install ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI
pip install -r requirements.txt
2. Install Hunyuan3D ComfyUI Nodes
cd ComfyUI/custom_nodes
git clone https://github.com/sdbds/Hunyuan3D-2-for-ComfyUI
cd Hunyuan3D-2-for-ComfyUI
pip install -r requirements.txt
3. Install Additional Dependencies
Hunyuan3D requires some specialized libraries:
pip install trimesh open3d rembg
4. Download Model Weights
huggingface-cli download tencent/Hunyuan3D-2 \
--local-dir ./models/hunyuan3d-2/
The download is ~15GB. Weights go in ComfyUI/models/hunyuan3d/
Running
Start ComfyUI:
python main.py --listen
Basic Image-to-3D Workflow
- Load the
hunyuan3d_i2mesh.jsonworkflow - Upload your input image
- Set Remove Background to Auto (for product shots) or Off (if already transparent)
- Run generation
Workflow Settings
| Parameter | Value | Notes |
|---|---|---|
| Steps | 50 | Don't reduce below 30 |
| Octree Resolution | 380 | Higher = more detail, more VRAM |
| Marching Cubes Resolution | 256 | Mesh density |
| Seed | Any | Set for reproducibility |
Input Image Tips
Best inputs for Hunyuan3D-2:
- Single object with clear silhouette
- White or transparent background
- Good lighting from front or 3/4 angle
- Square crop (1:1)
Works well:
- Product shots (sneakers, furniture, electronics)
- Toys and figurines
- Characters from 2D art
- Architecture models
Doesn't work well:
- Complex scenes with multiple objects
- Photos of people (legal/ethical considerations)
- Abstract shapes without clear structure
Processing the Output in Blender
Import GLB
- Open Blender 4.0+
File → Import → glTF 2.0 (.glb)- Select your generated file
Quick Cleanup
# Blender Python console — remove doubles and recalculate normals
import bpy
obj = bpy.context.active_object
bpy.ops.object.mode_set(mode='EDIT')
bpy.ops.mesh.remove_doubles(threshold=0.001)
bpy.ops.mesh.normals_make_consistent(inside=False)
bpy.ops.object.mode_set(mode='OBJECT')
Texture Baking
If you need a specific texture resolution:
- Add a new Image Texture node in the material
- Create a 2048×2048 image
- Use
Cycles → Bake → Diffuseto bake at higher resolution
Generation Speed
| Octree Res | Mesh Res | Time | VRAM | Quality |
|---|---|---|---|---|
| 380 | 256 | ~30s | 12GB | Good |
| 380 | 512 | ~60s | 18GB | Better |
| 512 | 256 | ~45s | 16GB | Best detail |
RTX 4090, approximate values. Community data pending.
Using with Blender MCP (Advanced)
Combine Hunyuan3D-2 with blender-mcp and a local LLM for AI-assisted 3D workflows:
- Install blender-mcp in Blender
- Connect Claude Code or a local LLM
- Generate 3D assets via natural language: "Create a low-poly tree from this reference image"
This pipeline — image → Hunyuan3D-2 → Blender → LLM editing — represents one of the most unique self-hosted AI workflows available.
Troubleshooting
OOM at 12GB: Reduce Octree Resolution to 256, Marching Cubes to 128
Mesh has holes or artifacts: Input image may have ambiguous depth cues. Try a more front-facing angle.
Texture looks wrong: Enable "Remove Background" and ensure the object is centered in frame
Slow generation: Check GPU is being used with nvidia-smi. If CPU fallback: add --gpu-only flag
Related 3D Models
| Model | Best For | Notes |
|---|---|---|
| Hunyuan3D-2 | General objects, products | Best quality overall |
| TRELLIS | Detailed objects | Microsoft, higher VRAM |
| Stable Fast 3D | Speed priority | Lower quality, 2-5s |
This is one of the few detailed local 3D generation guides available. The cloud bias in most AI tutorials means self-hosted 3D content is an underserved niche.