教程Hugging Face今天

SimReady Central 开源 3D 物理资产库导入 Isaac Lab 与 MuJoCo 实操指南

手把手演示如何从 Hugging Face SimReady Central 拉取带真实质量、碰撞网格与摩擦系数的 OpenUSD 资产，并在 NVIDIA Isaac Lab 中构建高并行双臂抓取训练环境。

仿真与训练
数据与采集

Hugging Face 联合 Lightwheel 等生态伙伴发布的 SimReady Central 提供了 2,000+ 个开箱即用的物理仿真就绪（Sim-Ready）OpenUSD 3D 资产。与传统视觉 3D 模型（仅有网格纹理、无刚体物理属性）不同，SimReady 资产已预先标定好凸包碰撞网格（Convex Decomposition）、真实质量密度、静/动摩擦系数及铰接关节限制。

本教程演示如何在 5 分钟内将其接入 Isaac Lab 用于 Franka Research 3 或宇树 G1 的操作训练。

Step 1：使用 `huggingface_hub` 批量拉取 OpenUSD 资产

安装依赖并按类别下载厨房、工业零件或日常容器资产包：

python

from huggingface_hub import snapshot_download

asset_dir = snapshot_download(
    repo_id="LightwheelAI/SimReady-Central",
    allow_patterns=["assets/industrial_parts/**", "assets/tabletop_objects/**"],
    local_dir="./simready_assets",
)
print(f"SimReady assets downloaded to: {asset_dir}")

Step 2：在 Isaac Lab 环境配置中挂载刚体资产 (`RigidObjectCfg`)

在 Isaac Lab 的 DirectRLEnvCfg 或 ManagerBasedRLEnvCfg 中，直接通过 UsdFileCfg 引用下载好的 .usd 文件，无需手动补充 RigidBodyAPI 或 MassAPI：

python

import isaaclab.sim as sim_utils
from isaaclab.assets import RigidObjectCfg

target_object = RigidObjectCfg(
    prim_path="{ENV_REGEX_NS}/TargetObject",
    spawn=sim_utils.UsdFileCfg(
        usd_path="./simready_assets/assets/industrial_parts/gear_shaft_01.usd",
        rigid_props=sim_utils.RigidBodyPropertiesCfg(
            solver_position_iteration_count=16,
            solver_velocity_iteration_count=4,
            max_depenetration_velocity=1.0,
        ),
    ),
    init_state=RigidObjectCfg.InitialStateCfg(pos=(0.45, 0.0, 0.05)),
)

Step 3：碰撞精度与 Sim-to-Real 域随机化检查清单

接触求解器步数：对于精密插拔或小零件抓取，建议将 PhysX TGS 求解器的 solver_position_iteration_count 设为 16 以上，防止薄壁穿模。
整机本体模型配套：机器人本体的官方 URDF / MJCF / USD 模型可直接在本站 仿真资产库 (URDF/MJCF) 一键获取。