如何下载UniML3D数据集UniMate的Hugging Face下载全流程教程【免费下载链接】UniMate[SIGGRAPH Asia 2026] UniMate: One Unified Model to Animate Diverse Skeletons项目地址: https://gitcode.com/GitHub_Trending/un/UniMateUniMate是 SIGGRAPH Asia 2026 论文《One Unified Model to Animate Diverse Skeletons》提出的统一骨骼动画模型其配套数据集UniML3D包含13,006 条文本配对的动作序列。本文带你完整走一遍 UniML3D 数据集的 Hugging Face 下载流程环境准备、官方下载命令、快捷通道与常见问题排查零基础也能照着做完。 UniML3D数据集是什么UniML3D 是一个覆盖多种骨骼拓扑的大规模动作数据集包括双足、四足、鸟类、海洋生物、昆虫形、蛇形以及铰接刚体七大类骨架所有数据都经过了统一的规范化处理。它由三个来源组成Mixamo— 人形角色动画与绑定角色Objaverse-XL— 带骨骼绑定并附带动画的 3D 物体Truebones ZOO— 动物动作商业授权下文单独说明上图为 UniMate 用同一个统一模型为不同骨架生成的动画——从飞鸟、巨龙到人形、机器人甚至会开花的花朵这些都由 UniML3D 数据集支撑训练。上图展示了数据集的内容组织方式每条动作片段都配有一句简短的文本描述如 A dragon flaps its wings and glides forward这正是文本驱动动作生成的核心。⚙️ 下载前准备3步配置环境第一步克隆UniMate代码仓库官方下载脚本内置在仓库中先克隆并进入项目目录git clone https://gitcode.com/GitHub_Trending/un/UniMate cd UniMate第二步创建conda环境整个项目数据处理、训练、推理共用一个 conda 环境依赖定义在 requirements.txt 中conda create -n unimate python3.10 -y conda activate unimate pip install setuptools81 pip install -r requirements.txt --no-build-isolation第三步确认hf CLI可用下载阶段基于hf命令行工具它随huggingface_hub包一起安装已包含在依赖列表中无需额外操作。如果目标是受限/私有数据集需要先登录hf auth login或者在 shell 中导出HF_TOKEN环境变量效果相同。 UniML3D数据集下载命令四大官方仓库一览所有原始数据都通过 Stage 0 脚本 data_process/scripts/run_download.sh 下载默认落盘到dataset/raw/数据集名/数据集名Hugging Face 仓库内容mixamoLinzhan/Mixamo-Animations-Characters人形动画 绑定角色objaverseLinzhan/Objaverse-XL-Rigged-Animated带骨骼绑定 动画的 GLB 资产objaverse_rendersLinzhan/Objaverse-XL-Rigged-Animated-Renders多视角渲染视频 T-pose 图约 6 GB可选truebonesLinzhan/Truebones-ZOO-Annotations仅标注文件无动作数据见下文四条下载命令如下按需执行bash data_process/scripts/run_download.sh mixamo # 人形动画 角色 bash data_process/scripts/run_download.sh objaverse # 绑定 动画 GLB bash data_process/scripts/run_download.sh objaverse_renders # 可选约 6 GB bash data_process/scripts/run_download.sh truebones # 仅标注 命令后面的额外参数会直接透传给hf download例如bash data_process/scripts/run_download.sh objaverse --include glb/*可以只下载 GLB 文件、跳过元数据。⚡ 快捷通道直接下载处理好的UniML3D免跑3个处理阶段如果你不需要自己重跑导出 → 渲染 → 描述这套数据处理流水线官方已经把这三个阶段的合并产出发布成了Linzhan/UniML3D数据集一条命令即可拉取见 data_process/README.mdhf download Linzhan/UniML3D --type dataset --local-dir dataset --include export/* bash data_process/scripts/run_extract_features.sh objaverse第二条命令只运行 Stage 4特征提取就能直接复现最终的训练片段dataset/features/dataset/是获取可用数据最快的方式。两点注意Truebones 的动作 NPZ 不包含在内——原因见下文的商业授权说明其余全部数据包括所有文本描述与标注都完整提供本版本的动作描述经过重新处理风格可能与项目页展示的提示词不完全一致。⚠️ Truebones商业数据为什么下载不到动作文件Truebones ZOO 动物动作包是商业产品其授权协议不允许再分发因此官方仓库只提供标注提示词、元数据、渲染图、构建脚本。如需完整数据到 Truebones 官网购买 ZOO 动作包将资产解压到dataset/raw/truebones/Truebone_Z-OO/每种动物一个文件夹如Dog-2/用下载得到的scripts/pipeline/脚本重建按片段组织的animation/目录每个片段一个 FBX命名为{Species}-{Action}.fbx注意物种名中不能包含-第一个短横线是物种与动作的分隔符。 下载完成后目录结构与下一步按 data_process/README.md 的目录约定原始资产会落在dataset/raw/ ├── mixamo/ # animation_motion、character_refined 等 ├── objaverse/ # glb/ └── truebones/ # 标注文件 自行购买的动作资产之后有两条路线完整流水线依次运行 Export → Render → Caption → 关节标注 → Extract把原始资产加工成训练片段各阶段均可断点续跑直接训练拿到dataset/features/dataset/后用 configs/ 中的 JSON 配置启动训练命令详见 README.md 的 Training 部分。上图是数据集的最终用途示例输入一句话提示词UniMate 即可为任意骨架实时生成匹配的动作。❓ 常见问题排查Q1脚本提示hfCLI 未安装hfCLI 随requirements.txt中的huggingface_hub一起安装。确认已在unimateconda 环境里执行过依赖安装报错信息中也会给出独立的安装方式。Q2下载受限数据集报 401/403先执行hf auth login或在环境中导出HF_TOKEN再重试。Q3下载中断了怎么办直接重跑同一条命令即可hf会利用本地缓存继续下载不会重复拉取已完成的部分。Q4想更换下载位置设置RAW_DIR环境变量覆盖默认路径例如RAW_DIR/data/datasets/objaverse bash data_process/scripts/run_download.sh objaverseQ5objaverse_renders一定要下吗不必。它只是一个约 6 GB 的渲染镜像四视角片段 MP4 T-pose 网格图仅在你需要直接查看/复用渲染结果时下载。✅ 小结目标命令/方式下载人形数据run_download.sh mixamo下载物体数据run_download.sh objaverse最快拿到可用训练片段hf download Linzhan/UniML3D --include export/* Stage 4 提取动物动作数据官网购买 Truebones ZOO 后按规范解压掌握以上流程后你既能获取 UniML3D 的原始资产也能通过快捷通道在最短时间内拿到可训练的数据片段开始你的 UniMate 实验吧 【免费下载链接】UniMate[SIGGRAPH Asia 2026] UniMate: One Unified Model to Animate Diverse Skeletons项目地址: https://gitcode.com/GitHub_Trending/un/UniMate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考