apozz/hy-worldmirror-2-bf16

HY-WorldMirror 2.0 — bf16 rehost

This repository contains a modified redistribution of tencent/HY-World-2.0 (specifically the HY-WorldMirror-2.0/ subfolder), cast from fp32 to bfloat16 for faster download and load on consumer GPUs. Selected numerically-critical layers are kept in fp32 to match the upstream inference contract.

Modification notice (per Tencent HY-WORLD 2.0 Community License §3.b)

The following changes have been made relative to the upstream weights at tencent/HY-World-2.0/HY-WorldMirror-2.0/:

• model.safetensors has been cast from float32 to bfloat16 for every floating-point tensor except those matching the upstream _collect_fp32_critical_modules contract (any *.fc2.weight / *.fc2.bias in MLP blocks, and any *.scratch.output_conv2.* inside the DPT head). Those tensors are preserved as float32.
• File size: 5.05 GB → 3.27 GB (~35 % reduction).
• No architectural changes; config.json is unmodified from upstream.

The original fp32 weights remain available at tencent/HY-World-2.0/HY-WorldMirror-2.0/.

License

Use of this model is governed by the Tencent HY-WORLD 2.0 Community License — see LICENSE in this repository for the full text.

Tencent HY-WORLD 2.0 is licensed under the Tencent HY-WORLD 2.0 Community License, Copyright © 2025 Tencent. All Rights Reserved.

Territory restriction

The Tencent HY-WORLD 2.0 Community License limits distribution to the Territory, defined as the worldwide territory excluding the European Union, the United Kingdom, and South Korea (License §1.l). If you are in one of those jurisdictions, please obtain the model from a source that is licensed for your territory.

Files

File	Size	Description
model.safetensors	3.27 GB	bf16 + selective fp32 weights
config.json	842 B	Model constructor kwargs (unmodified upstream)
LICENSE	16.5 KB	Full text of the Tencent HY-WORLD 2.0 Community License

Usage

Drop-in replacement for the upstream subfolder. Example with ComfyUI-HYWM2:

from huggingface_hub import snapshot_download
local_dir = snapshot_download(
    "apozz/hy-worldmirror-2-bf16",
    allow_patterns=["model.safetensors", "config.json"],
)

Or via the upstream WorldMirrorPipeline:

from hyworld2.worldrecon.pipeline import WorldMirrorPipeline
pipeline = WorldMirrorPipeline.from_pretrained(
    "apozz/hy-worldmirror-2-bf16",
    subfolder="",  # files at repo root, not in HY-WorldMirror-2.0/
    enable_bf16=True,
)

Acknowledgements

Original model: Tencent Hunyuan / HY-World 2.0 / WorldMirror 2.0. Upstream code: https://github.com/Tencent-Hunyuan/HY-World-2.0.