LEAPP 导出
中文译本 · 原文 LEAPP 导出
把微调后的策略导出成可部署的 LEAPP 包。
用 LEAPP 导出之后,运行时是纯 C++,不再需要 Python。导出还会带上元数据,把策略自动接到需要的传感器输入和指令输出,不必再写额外代码。
在 x86_64 工作站上跑。GR00T 的 LEAPP 导出不支持 Jetson AGX Thor。
前提
微调课如果还没克隆导出仓库:
git clone --branch gr00t_workflow_0.1 --recurse-submodules https://github.com/nvidia-isaac/gr00t-leapp-export.git cd gr00t-leapp-export uv sync --python 3.10
执行导出
重要
G1 微调必须传 --joint_config export/data/g1_joints.json。没有这个参数时,导出会用占位关节名,部署时关节映射会失败或发出错误动作。
cd gr00t-leapp-export
uv run python export/export_with_leapp.py \
--model_path <checkpoint-dir> \
--embodiment_tag new_embodiment \
--dataset_path <lerobot-dataset-dir> \
--joint_config export/data/g1_joints.json \
--output_name <export-name>
--model_path:微调得到的checkpoint-NNNN/。--embodiment_tag:始终是new_embodiment。G1 不是 GR00T 开箱即用的本体。--dataset_path:微调用的那份 LeRobot 数据集。--joint_config:G1 关节配置。--output_name:导出 LEAPP 包的目录名。
在工作站 GPU 上,trace 通常要 5 到 15 分钟。成功时以 Export completed: <export-name> 结束。
导出内容
<export-name>.yaml:策略全部元数据。<export-name>.png:策略网络图。log.txt:导出日志。
权重是这些 ONNX 文件:
backbone.onnx和backbone.onnx.dataaction_head.onnx和action_head.onnx.datapreprocess_state.onnxpreprocess_video.onnxdecode_action.onnx
部署栈会读这些文件来跑策略,并把它接到正确的传感器输入和硬件输出。