HY-World 2.0 模型库Model Zoo完整指南快速下载与配置WorldMirror/Pano/WorldStereo权重【免费下载链接】HY-World-2.0HY-World 2.0: A Multi-Modal World Model for Reconstructing, Generating, and Simulating 3D Worlds项目地址: https://gitcode.com/gh_mirrors/hy/HY-World-2.0HY-World 2.0是一个多模态 3D 世界模型可以从文本、单图、多视角图片或视频生成/重建可交互的 3D 世界3DGS 网格与高斯点云。它的模型库Model Zoo包含WorldMirror、HY-Pano、WorldStereo三大系列权重。本文将用一篇完整指南带你快速完成 HY-World 2.0 权重的下载、加载与配置零基础上手世界模型推理。 先看懂HY-World 2.0 的模型家族HY-World 2.0 由四大阶段串联而成全景生成HY-Pano 2.0→ 轨迹规划WorldNav→ 世界扩展WorldStereo 2.0→ 世界组合WorldMirror 2.0 3DGS 训练。三大权重各自负责其中一个核心环节 模型权重清单一文看全三大系列官方模型库汇总了以下权重来源README.md 的 Model Zoo 章节系列模型用途参数量说明世界重建WorldMirror-2多视角图片/视频 → 3D 重建~1.2B单次前向预测深度、法线、相机、点云与 3DGS世界重建WorldMirror-1多视角图片/视频 → 3D 重建旧版~1.2B兼容旧任务可继续用全景生成HY-Pano-2文本/图片 → 360° 全景图~80BHunyuanImage-3 完整推理管线全景生成HY-Pano-2-Qwen文本/图片 → 360° 全景图~425M轻量 LoRA基于 Qwen-Image-Edit世界扩展WorldStereo-2全景图 → 3DGS 世界~17B扩散式关键帧生成带内存一致性好消息大部分权重托管在同一个 Hugging Face 仓库tencent/HY-World-2.0中按子文件夹组织WorldStereo-2 独立托管在hanshanxue/WorldStereo仓库。推理代码会在首次运行时自动下载权重无需手动配置环境变量。 第一步克隆仓库并安装环境所有权重配置都建立在代码环境之上。推荐CUDA 12.8 Python 3.11官方建议先用一个共享环境把 WorldMirror 跑通再补装 World Generation 的额外依赖详见 README.md 的 Get Started 章节git clone https://gitcode.com/gh_mirrors/hy/HY-World-2.0 cd HY-World-2.0 pip install -r requirements.txt WorldMirror 2.0世界重建权重加载配置WorldMirror 2.0 是统一的前馈式重建模型一次前向推理同时输出3D 点云、逐视角深度图、表面法线、相机位姿与内参、以及 3D Gaussian Splatting 属性均值、尺度、旋转、不透明度、SH 系数。方式一在线自动下载最简单权重位于 HF 仓库的HY-WorldMirror-2.0子文件夹model.safetensors 配置文件默认自动拉取只需一行加载from hyworld2.worldrecon.pipeline import WorldMirrorPipeline pipeline WorldMirrorPipeline.from_pretrained(tencent/HY-World-2.0) result pipeline(path/to/images) # 图片目录或视频文件加载逻辑在 hyworld2/worldrecon/pipeline.py它会自动识别本地目录中的model.safetensors config否则从 HF 下载。方式二本地 checkpoint 手动配置已手动下载权重时通过ckpt_pathconfig_path指到本地文件跳过任何网络请求pipeline WorldMirrorPipeline.from_pretrained( pretrained_model_name_or_pathtencent/HY-World-2.0, ckpt_path/path/to/checkpoint.safetensors, config_path/path/to/config.yaml, )命令行同样支持--ckpt_path/--config_path参数见 DOCUMENTATION.md 的 CLI Reference。用本地样例场景试跑效果可以直接使用仓库自带的 examples/worldrecon 数据集例如进阶配置省显存与多卡禁用不需要的预测头省显存最多释放约 200M 参数disable_heads[normal, points]可选camera / depth / normal / points / gs多卡 FSDP bf16推理注意输入图片数 ≥ GPU 数torchrun --nproc_per_node2 -m hyworld2.worldrecon.pipeline \ --input_path path/to/images --use_fsdp --enable_bf16 HY-Pano 2.0全景生成权重的两种后端HY-Pano 2.0 把单张透视照片或文本扩展为 360° 等距柱状全景图提供两种权重方案后端脚本权重形态特点HunyuanImage-3~80Bhyworld2/panogen/pipeline.py完整模型HY-Pano-2.0子文件夹带思考→改写→扩散推理链质量更高Qwen-Image-Edit LoRA~425Mhyworld2/panogen/pipeline_with_qwen_image.py轻量 LoRApytorch_lora_weights.safetensors加载快、易集成GPU 门槛低后端一HunyuanImage-3默认模型 ID 为tencent/HY-World-2.0子文件夹HY-Pano-2.0见 pipeline.py首次运行自动下载from pipeline import HunyuanPanoPipeline pipeline HunyuanPanoPipeline.from_pretrained(tencent/HY-World-2.0) output pipeline(input.png) output.save(output_panorama.png) # 默认输出 1920×960 全景也可传本地路径HunyuanPanoPipeline.from_pretrained(/path/to/HY-Pano-2.0)。后端二Qwen LoRA基座模型用 Qwen-Image-Edit-2509LoRA 权重从同一 HF 仓库的HY-Pano-2.0子文件夹下载from pipeline_with_qwen_image import HunyuanPanoPipeline pipeline HunyuanPanoPipeline.from_pretrained( lora_pathtencent/HY-World-2.0, lora_subfolderHY-Pano-2.0) output pipeline(input.png)完整参数--seed、--diff-infer-steps、--use-taylor-cache加速等参考 hyworld2/panogen/README.md。 WorldStereo 2.0世界扩展权重的配置要点WorldStereo 2.0 是 ~17B 的扩散式视频生成模型负责沿规划轨迹把全景扩展成一致的高清关键帧序列是整条生成管线中最吃显存的环节。权重位置托管在 HF 仓库hanshanxue/WorldStereo代码在 hyworld2/worldgen/video_gen.py 中指定运行时自动下载加载入口hyworld2/worldgen/models/worldstereo_wrapper.py 提供 diffusers 风格的WorldStereo.from_pretrained(repo_id, subfolder...)支持local_files_onlyTrue走本地缓存、fsdpTrue多卡分片模型变体worldstereo-memory完整多步推理与worldstereo-memory-dmdDMD 蒸馏四步推理默认推荐跑通完整世界生成轨迹规划 → 轨迹渲染 → 世界扩展 → GS 数据 → 3DGS 训练的命令与参数请见 hyworld2/worldgen/README.md建议≥4 张 GPU官方在 8×H20 上验证扩展阶段示例torchrun --nproc_per_node 8 video_gen.py --target_path /path/to/scene --fsdp✅ 权重配置避坑清单自动下载 vs 手动下载三个系列都支持首次运行自动从 HF 拉取离线/内网环境请手动下载后传本地路径ckpt_path、from_pretrained(/path/...)、local_files_onlyTrue子文件夹别搞混WorldMirror 权重在HY-WorldMirror-2.0Pano 权重在HY-Pano-2.0二者同属tencent/HY-World-2.0仓库WorldMirror 多卡输入图片数必须 ≥ GPU 数否则直接报错显存不足时WorldMirror 用disable_heads裁剪预测头、加fsdp_cpu_offloadPano 选轻量 Qwen LoRA 后端详细参数表所有推理参数保存项、掩码、压缩、先验注入完整列表见 DOCUMENTATION.md 总结HY-World 2.0 的模型库设计得很清爽WorldMirror-21.2B负责照片变 3DHY-Pano-280B / 425M 双后端负责单图变全景WorldStereo-217B负责全景变可进入的世界。权重默认自动下载配合ckpt_path/ 本地路径即可离线部署。装上环境、跑通 WorldMirror你就已经拥有了一个完整的 3D 世界工具箱 【免费下载链接】HY-World-2.0HY-World 2.0: A Multi-Modal World Model for Reconstructing, Generating, and Simulating 3D Worlds项目地址: https://gitcode.com/gh_mirrors/hy/HY-World-2.0创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考