LeRobot 机器人学习框架教程如何用 3 条命令跑通 SO-100 数据采集与 ACT 策略训练【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobotLeRobot 是 Hugging Face 开源的 PyTorch 机器人学习框架打通硬件控制、数据采集和策略训练。这篇教程带你装好环境并走一遍从遥操作录数据到训练出策略的完整链路。值不值得试先看你踩不踩这些坑上手机器人学习最常见的三个卡点硬件各写各的 APISO-100 的控制代码搬到别的手臂上基本要重写采集到的数据散落成 MP4 加 CSV别人无法直接用自己也难复用想试 ACT、Pi0 这类新策略得自己拼数据管线和训练脚本。LeRobot 就是冲着这三件事来的一个统一的Robot接口接管 SO-100、LeKiwi、Unitree G1 等十几款硬件一个 LeRobotDataset 标准格式收纳全部数据Hugging Face Hub 上已有数千个公开数据集内置 ACT、Diffusion、Pi0、GR00T 等一批现成策略。核心概念LeRobot 靠什么把三件事串起来一句话拆解它的架构接口层 数据层 策略层。接口层所有硬件实现同一个Robot接口你只调connect()、get_observation()、send_action()三个动作换硬件不改代码数据层LeRobotDataset 把观测存成 MP4 视频、状态和动作存成 Parquet两者按帧对齐支持流式读取和可视化策略层模仿学习ACT、Diffusion、VQ-BeT、强化学习HIL-SERL、TDMPC、视觉-语言-动作模型Pi0、GR00T N1.7、SmolVLA都是纯 PyTorch 实现训练和推理共用同一套数据接口。数据层的存储分工可以这样记数据内容存储格式作用相机观测帧MP4 视频压缩存储按帧解码状态 / 动作Parquet列式存储读取快数据集描述元数据特征、时间戳、episode 划分快速安装 LeRobot环境要求与一步到位命令环境要求很明确Python 3.12PyTorch 2.10视频解码依赖ffmpeg。装之前建议先建一个干净环境避免和别的项目的依赖打架。conda create -y -n lerobot python3.12 conda activate lerobot pip install lerobot[core_scripts] conda install ffmpeg -c conda-forgecore_scripts这个 extra 包含了datasethardwareviz三组依赖够你用lerobot-record、lerobot-replay这些采集回放命令后面要训练再补pip install lerobot[training]。成功的标志运行lerobot-info能打印出版本和已加载的功能模块就说明装好了。上手走一遍SO-100 遥操作录数据、ACT 策略训练以最典型的 SO-100 桌面机械臂为例整条链路是配置电机 → 遥操作录数据 → 训练 → 评估。硬件相关的准备命令找端口lerobot-find-port、写电机 IDlerobot-setup-motors、标定lerobot-calibrate都带交互引导跟着提示按回车就行。核心流程命令对照lerobot-record具体参数按你装的机器人和遥操作器类型填阶段命令说明录数据lerobot-record --robot.type... --teleop.type... --dataset.repo_id用户名/数据集名主臂带动从臂逐 episode 记录看数据lerobot-dataset-viz 数据集路径浏览器里回放采集结果训练见下方代码块ACT 策略跑通即得第一个 checkpoint评估lerobot-eval --env.typelibero --env.tasklibero_object --eval.n_episodes10在 LIBERO 仿真基准上验证训练本身真的只是两行参数lerobot-train \ --policy.typeact \ --dataset.repo_idlerobot/aloha_mobile_cabinet成功的标志训练日志出现逐步下降的 losscheckpoints/目录里生成 checkpoint 文件。第一次跑 LeRobot 的常见坑与修复坑 1串口打不开报 Permission denied现象是连接电机时报/dev/ttyACM0无法读写。原因是 Linux 默认不给普通用户 USB 串口权限。解决sudo chmod 666 /dev/ttyACM0多总线时把 ttyACM1 等一并放开。坑 2加载数据集时视频解码报错原因是 TorchCodec 解码需要ffmpeg而很多机器上没装。解决conda install ffmpeg -c conda-forgeIntel 版 macOS、Linux ARM 等平台会自动回退到 pyav可以跳过。坑 3训练时 CUDA out of memory原因是 VLA 类模型参数量大batch 一次塞不下。解决减小 batch size、开梯度累积或降低输入图像分辨率再重新采数。进一步资源文档与源码目录清单安装与平台适配细节docs/source/installation.mdx各款机器人的组装与配置指南SO-100 全流程在 docs/source/so100.mdx硬件抽象层源码src/lerobot/robots/策略模型实现src/lerobot/policies/数据集读写与统计工具src/lerobot/datasets/可运行的场景示例遥操作、训练、回放examples/第三方机器人插件机制装lerobot_robot_名称前缀的包即可被 CLI 自动发现详见 docs/source/third_party_robots.mdx LeRobot 把机器人学习最碎的三块——硬件、数据、策略——收进了一个 PyTorch 框架里。下一步就动手把examples/里的 SO-100 流程跑一遍遇到硬件或参数问题直接在仓库提 Issue 找维护者确认。【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考