ComfyUI_HYWorld2
A ComfyUI extension with 43 custom nodes.
Nodes (43)
Turning finished world renders into a training dataset
Preparing the training data the 3D Gaussian Splat trainer eats
Expanding your world with a ComfyUI model of your choice (experimental)
Glueing multiple camera passes into one coherent point cloud
The scene's long-term memory, and how HY-World2 stops worlds drifting apart
Packing your memory bank into the exact format WorldMirror wants
Prepping the canvas and conditioning for Qwen panorama expansion
The actual panorama generator — Qwen-based 360° outpainting
The prompt cookbook for Qwen panoramic expansion
The last 32 pixels — fixing the wrap seam on your 360
The VLM that reads your scene and writes the captions the pipeline feeds on
The slow road to a beautiful splat — training 3D Gaussian Splatting
Where the camera paths through your 3D world get planned
The anchor every HY-World2 scene hangs from
The node that makes a still scene explorable
Surgically editing a gaussian splat by painting over views (experimental)
Where you finally get to look at your gaussian splat
Scripting the camera moves before the video model rolls
Pulling the cameras and point cloud out of a PLY_DATA bundle
Slicing a 360 panorama into the perspective views WorldMirror can digest
Export a WorldStereo model to a single .safetensors file
One node that installs the pack's heavy dependencies for you
Bring a saved .ply back into the graph with its cameras
The loader that downloads Tencent's WorldMirror for you
Loading the HY-World 2.0 / WorldMirror V2 checkpoint
The int4 WorldStereo loader for smaller GPUs
Loading the WorldStereo pipeline (and its MoGe depth helper)
Unwrapping a panorama into flat room walls
🎥 Render your saved splat from any camera angle
💾 Getting your reconstruction onto disk as a .ply
🧩 The node that stitches your splat repairs back together
🧩 Render a splat, find the holes, prep them for repair
🧩 Splat Patch POC 2 — the triage node that scans the whole scene
🧩 Splat Patch POC v2 — same job, revised knobs
🔥 The backprop pass that cleans up your raw splats
Assemble a native 3DGS training dataset from your reconstruction
Turn a reconstruction into a WorldGen workspace
Turn a single photo into an explorable 3D room with WorldMirror
WorldMirror 3D, the trimmed 'official' variant
The V2 reconstruction node with splat upsampling built in
Single image and panoramas to point cloud, depth, and Gaussian splats
One-click low-VRAM mode and dense high-res splats
Camera-guided video generation with WorldStereo
ComfyUI HY-World 2.0 - WorldMirror 3D
ComfyUI custom nodes for 3D scene reconstruction from a single image, panorama, image set, or video using HY-World 2.0 / WorldMirror.
Nodes
Category: VNCCS/3D
| Node | Description |
|------|-------------|
| VNCCS_LoadWorldMirrorModel | Download and load WorldMirror V1 model |
| VNCCS_WorldMirror3D | V1 inference: PLY point cloud, depth, normals, Gaussian splat |
| VNCCS_LoadWorldMirrorV2Model | Download and load WorldMirror V2 model |
| VNCCS_WorldMirrorV2_3D | V2 inference: PLY point cloud, depth, normals, Gaussian splat |
| VNCCS_WorldMirrorV2_3D_Clean | V2 reconstruction defaults for cleaner dense splats |
| VNCCS_PLYSceneRenderer | Render PLY scenes from arbitrary camera angles |
| VNCCS_SplatRefiner | Refine Gaussian splat data |
| VNCCS_DecomposePLYData | Extract XYZ / RGB / normals / opacity tensors from PLY |
| VNCCS_SavePLY | Save PLY files to disk |
| VNCCS_Equirect360ToViews | Extract perspective views from equirectangular panoramas |
| VNCCS_PanoramaMapper | Map panoramas to wall / floor / ceiling projections |
Installation
Via ComfyUI Manager
Search for HY-World 2.0 and click Install. requirements.txt and install.py run automatically.
install.py installs the HY-World vendored gsplat_maskgaussian fork from:
hyworld2/worldgen/third_party/gsplat_maskgaussian
Do not install upstream/PyPI gsplat separately. HY-World worldgen and the native scene trainer require fork-only rasterization arguments such as distloss and gauss_masks; the project must have only one installed Python package named gsplat.
Manual
cd ComfyUI/custom_nodes
git clone https://github.com/AHEKOT/ComfyUI_HYWorld2
cd ComfyUI_HYWorld2
pip install -r requirements.txt
python install.py
HY-World gsplat_maskgaussian
gsplat_maskgaussian is a CUDA extension and is built from the vendored HY-World source. It replaces upstream gsplat under the same package name.
Required build tools:
- CUDA Toolkit matching the PyTorch CUDA major/minor version as closely as possible.
- MSVC C++ Build Tools on Windows with the Desktop development with C++ workload.
ninja, listed inrequirements.txt.- Git, if the vendored GLM headers need to be restored.
Manual rebuild:
# Windows embedded ComfyUI Python
scripts\pipinstall.bat
# Any Python environment
python scripts/build_gsplat.py
Successful installation is verified by a CUDA smoke test that calls gsplat.rendering.rasterization with distloss=True and gauss_masks.
Workflows
Example workflows are in the workflows/ directory:
World-single-image.json- single image to 3D sceneWorld-Mirror-panorama.json- equirectangular panorama to 3D scene
Requirements
- Python 3.10+
- PyTorch with CUDA
- NVIDIA GPU for gsplat rendering/training
- Flash Attention for HY-World model inference where supported:
pip install flash-attn --no-build-isolation