---
license: other
license_name: tencent-hy-world-2-community-license
license_link: LICENSE
tags:
- 3d-reconstruction
- gaussian-splatting
- computer-vision
- pytorch
- safetensors
base_model: tencent/HY-World-2.0
---

# HY-WorldMirror 2.0 — bf16 rehost

This repository contains a **modified** redistribution of
[`tencent/HY-World-2.0`](https://huggingface.co/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`](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`](https://github.com/PozzettiAndrea/ComfyUI-HYWM2):

```python
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`:

```python
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>.