World models · three_dimension

HunyuanWorld-Mirror

Tencent Hunyuan / HY-World

WorldFoundry exposes framework inference through the in-tree HunyuanMirrorPipeline and vendored inference-only WorldMirror model code.

Runner verified统一环境hunyuanworld-mirror

构建运行命令

选择仓库中已记录的 variant，然后复制对应的准备、检查或运行命令。

worldfoundry.pipeline

Variant

任务three_dimension

环境worldfoundry-unified-cu128

设备CUDA 12.8

worldfoundry-eval evaluate \
  --mode model \
  --model-id hunyuanworld-mirror \
  --model-runner worldfoundry:pipeline \
  --model-manifest-dir worldfoundry/data/models/catalog \
  --requests-path tmp/requests.jsonl \
  --output-dir tmp/model_eval/hunyuanworld-mirror \
  --metric artifact_count \
  --json

兼容性与版本

由 Manifest 生成

集成状态: integrated
Runner 证据: verified
环境: worldfoundry-unified-cu128
Python: 3.10
CUDA: CUDA 12.8
PyTorch: torch
源码 revision: —
Checkpoint revision: —

Runtime profile: hunyuanworld-mirror
Pipeline binding: hunyuanworld-mirror
Runner: worldfoundry.pipeline
Pipeline target: worldfoundry.pipelines.hunyuan_world.pipeline_hunyuan_mirror:HunyuanMirrorPipeline
Backend stage: framework_pipeline
Runtime 状态: framework_inference_gpu_verified
Driver 状态: compatible
环境类型: 统一环境

安装环境

环境解析器会读取已记录 profile，并选择此处显示的统一或独立环境。

bash scripts/setup/model_env_install.sh --model hunyuanworld-mirror

依赖版本约束 27

torch
torchvision
numpy<2.0.0
opencv-python
pillow_heif
scipy
einops
torchmetrics
trimesh
open3d==0.18.0
roma
matplotlib
tqdm
huggingface-hub[torch]>=0.22
jaxtyping
lpips
colorspacious
moviepy==1.0.3
plyfile
pycolmap==3.10.0
tyro
onnxruntime
safetensors
gradio==5.49.1
omegaconf
pydantic
requests

Conda 依赖 10

python
pip
ffmpeg
git
git-lfs
cmake
ninja
pkg-config
libgl
libglib

Checkpoint 与资产

分配算力前先做本地检查；gated、private 与 license 字段直接来自 checkpoint manifest。

worldfoundry-eval zoo model-download --model-id hunyuanworld-mirror --check-local --json

tencent/HunyuanWorld-Mirror

Revision: —
License: —
Gated: —
Private: —

运行与输出

生成的命令通过共享 evaluation 边界运行，并持久保存结果 manifest 与 artifact。

worldfoundry-eval evaluate \
  --mode model \
  --model-id hunyuanworld-mirror \
  --model-runner worldfoundry:pipeline \
  --model-manifest-dir worldfoundry/data/models/catalog \
  --requests-path tmp/requests.jsonl \
  --output-dir tmp/model_eval/hunyuanworld-mirror \
  --metric artifact_count \
  --json

输入契约

字段	已记录契约
`image`	Required
`prompt`	Optional
`video`	Optional

Artifact 契约

Artifact 类型	文件名 / 路径
`generated_3d_asset`	`hunyuan_mirror_outputs.zip`

证据与来源

Catalog 集成、原生 demo parity 与 runner parity 是三条独立记录。

集成状态: integrated
Runner 证据: verified
原生 Demo 证据: 未记录
验证 Imports: torch, numpy, cv2, PIL, huggingface_hub, pycolmap, open3d, onnxruntime

配方溯源

worldfoundry/data/models/catalog/world_models/hunyuanworld-mirror.yamlGitHubhttps://github.com/Tencent-Hunyuan/HunyuanWorld-MirrorHugging Facehttps://huggingface.co/tencent/HunyuanWorld-Mirror

构建运行命令

输入契约

Artifact 契约

相关配方