Files
2025-08-02 17:50:32 +02:00

215 lines
5.4 KiB
JSON

{
"workflows": {
"simple_3d_generation": {
"description": "Simple one-click 3D generation using the simplified wrapper",
"nodes": [
{
"id": 1,
"type": "LoadImage",
"inputs": {
"image": "your_image.png"
}
},
{
"id": 2,
"type": "HunyuanWorldSimplifiedWrapper",
"inputs": {
"image": ["1", 0],
"model_variant": "mini",
"resolution": 1024,
"enable_texture": true,
"filename_prefix": "simple_3d"
}
},
{
"id": 3,
"type": "PreviewImage",
"inputs": {
"images": ["2", 1]
}
}
]
},
"real_pipeline_3d": {
"description": "Using real Hunyuan3D pipeline for maximum quality",
"nodes": [
{
"id": 1,
"type": "LoadImage",
"inputs": {
"image": "your_image.png"
}
},
{
"id": 2,
"type": "HunyuanWorldModelLoader",
"inputs": {
"model_name": "tencent/Hunyuan3D-2mini",
"precision": "fp16",
"enable_texture": true,
"low_vram_mode": true
}
},
{
"id": 3,
"type": "HunyuanWorldImageTo3D",
"inputs": {
"pipeline": ["2", 0],
"image": ["1", 0],
"apply_texture": true,
"save_mesh": true,
"filename_prefix": "real_3d",
"seed": 42
}
},
{
"id": 4,
"type": "PreviewImage",
"inputs": {
"images": ["3", 2]
}
}
]
},
"native_comfyui_workflow": {
"description": "Using built-in ComfyUI Hunyuan3D nodes for maximum control",
"nodes": [
{
"id": 1,
"type": "LoadImage",
"inputs": {
"image": "your_image.png"
}
},
{
"id": 2,
"type": "CLIPVisionLoader",
"inputs": {
"clip_name": "clip_vision_model.safetensors"
}
},
{
"id": 3,
"type": "CLIPVisionEncode",
"inputs": {
"clip_vision": ["2", 0],
"image": ["1", 0]
}
},
{
"id": 4,
"type": "Hunyuan3Dv2Conditioning",
"inputs": {
"clip_vision_output": ["3", 0]
}
},
{
"id": 5,
"type": "EmptyLatentHunyuan3Dv2",
"inputs": {
"resolution": 1536,
"batch_size": 1
}
},
{
"id": 6,
"type": "CheckpointLoaderSimple",
"inputs": {
"ckpt_name": "hunyuan3d_model.safetensors"
}
},
{
"id": 7,
"type": "KSampler",
"inputs": {
"model": ["6", 0],
"positive": ["4", 0],
"negative": ["4", 1],
"latent_image": ["5", 0],
"seed": 42,
"steps": 20,
"cfg": 7.0,
"sampler_name": "euler",
"scheduler": "normal",
"denoise": 1.0
}
},
{
"id": 8,
"type": "VAEDecodeHunyuan3D",
"inputs": {
"samples": ["7", 0],
"vae": ["6", 2],
"num_chunks": 8000,
"octree_resolution": 256
}
},
{
"id": 9,
"type": "VoxelToMesh",
"inputs": {
"voxel": ["8", 0],
"threshold": 0.5
}
},
{
"id": 10,
"type": "SaveGLB",
"inputs": {
"mesh": ["9", 0],
"filename_prefix": "native_3d"
}
}
]
},
"hybrid_approach": {
"description": "Hybrid approach combining custom and native functionality",
"nodes": [
{
"id": 1,
"type": "LoadImage",
"inputs": {
"image": "your_image.png"
}
},
{
"id": 2,
"type": "HunyuanWorldHybridNode",
"inputs": {
"mode": "direct_pipeline",
"image": ["1", 0],
"model_name": "tencent/Hunyuan3D-2mini",
"use_texture": true,
"filename_prefix": "hybrid"
}
},
{
"id": 3,
"type": "PreviewImage",
"inputs": {
"images": ["2", 1]
}
}
]
}
},
"installation_guide": {
"step1": "Navigate to ComfyUI/custom_nodes/ComfyUI-HunyuanWorld",
"step2": "Run: pip install -r requirements.txt",
"step3": "Restart ComfyUI",
"step4": "Look for HunyuanWorld nodes in the node menu"
},
"model_recommendations": {
"beginners": "tencent/Hunyuan3D-2mini - Good balance of quality and speed",
"quality_focused": "tencent/Hunyuan3D-2 - Best quality, requires more VRAM",
"multi_view": "tencent/Hunyuan3D-2mv - Optimized for multiple view inputs",
"low_vram": "Use mini model with low_vram_mode=true and fp16 precision"
},
"tips": {
"input_images": "Use high-quality images (512x512+) with clear subjects",
"performance": "Enable low_vram_mode and use fp16 for better performance",
"quality": "Use higher resolution (3072) and full model for best results",
"troubleshooting": "Check README.md for common issues and solutions"
}
}