Add files via upload

2025-08-02 17:50:32 +02:00
parent 5392d81d2b
commit 28fe9cc014
16 changed files with 2577 additions and 0 deletions
@@ -0,0 +1,214 @@
+{
+  "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"
+  }
+}