MCAP 转 LeRobot
中文译本 · 原文 MCAP 转 LeRobot
把录好的 MCAP 会话转成 LeRobot,供 GR00T 微调。
- 在主机上安装 MCAP 到 LeRobot 的转换器。
- 把一个或多个录制会话合成一份 LeRobot 数据集。
- 核对输出路径和元数据能用于训练。
安装转换器
转换器是纯 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
- 输出目录有四个文件夹:
data/、meta/、videos/、images/。 - 有给 GR00T 微调用的
new_embodiment_config_defaults.py。 data/、meta/、videos/里有数据。images/存在但是空的。- episode 数和源会话对得上。
- 元数据里的
fps和录制器的sync_rate一致(默认 30 Hz)。
要点
MCAP 已经变成 LeRobot,可以拿去微调 GR00T。