首页 / Robot / G1 E2E / 数据导出

MCAP 转 LeRobot

中文译本 · 原文 MCAP 转 LeRobot

把录好的 MCAP 会话转成 LeRobot,供 GR00T 微调。

安装转换器

转换器是纯 Python,不需要 GPU,也不需要 ROS。x86_64 工作站或 Jetson AGX Thor 都可以跑。可以在 Isaac ROS 容器里跑,也可以直接在主机上跑。

提示

想跳过采集,用已经是 LeRobot 格式的官方真机数据集 nvidia/GR00T-N1.7-AppleToPlate。资产顺序是:数据集 → 训练 → checkpoint;数据集 + checkpoint → LEAPP 导出 → ONNX 模型。

hf download \
    nvidia/GR00T-N1.7-AppleToPlate \
    --repo-type dataset \
    --local-dir ${ISAAC_ROS_WS}/recordings/lerobot_output

isaac_ros_data_tools 在安装课时已经克隆。如果转换器跑在 x86 工作站而不是 Thor,先在工作站工作区里做安装课的 clone,再继续。

cd ${ISAAC_ROS_WS}/src/isaac_ros_data_tools/isaac_ros_mcap_lerobot_converter
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install -e .

转换一次录制

把 <session_name> 换成录制会话名。要合并多次会话,多传几个 --rosbags-dir,按列出的顺序把 episode 连续编号。

mcap-to-lerobot \
    --rosbags-dir ${ISAAC_ROS_WS}/recordings/<session_name> \
    --output-dir ${ISAAC_ROS_WS}/recordings/lerobot_output \
    --task "move the apple to the plate" \
    --fps 30 \
    --robot-type unitree_g1
提示

--output-dir 已存在时命令会失败。先删掉再转:

rm -r ${ISAAC_ROS_WS}/recordings/lerobot_output

给微调做检查

ls ${ISAAC_ROS_WS}/recordings/lerobot_output

要点

MCAP 已经变成 LeRobot,可以拿去微调 GR00T。