LeRobot教程5分钟跑通你的第一个机器人策略【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobot想让你的机械臂抓起杯子最头疼的往往不是算法而是接线串口驱动、相机索引、数据集整理、训练脚本每一步都可能踩坑。LeRobot 是一个基于 PyTorch 的开源机器人学习框架把录制演示数据 → 训练策略 → 在真机上跑起来串成几条命令让你一个下午就能跑通第一个策略。为什么是 LeRobot和从零自己搭相比差在哪你可能听说过 ACT、pi0、GR00T 这些算法但自己实现一遍得先写数据格式再写训练循环还要自己接硬件。LeRobot 的不同在于三点全流程是一条命令录制用lerobot-record训练用lerobot-train仿真评估用lerobot-eval不需要自己写主入口。所有命令的完整示例都在命令速查表里。数据集格式统一LeRobotDataset v3 把相机画面存成 MP4、状态和动作存成 ParquetHub 上已有上千个开源数据集一行代码直接加载。同一套代码通仿真和真机同一个策略既能拿自己录的数据训练也能直接在 LIBERO、MetaWorld 等仿真基准上验证。从零到第一个可用结果LeRobot 安装与验证环境要求只有一个硬门槛Python 3.12 及以上。pip install lerobot lerobot-info能打印出版本号和环境信息就说明装好了。基础包刻意做得轻量训练、数据集工具等依赖通过 extras 按需安装具体组合看安装文档。没有机器人也没关系。官方的数据集库里有很多现成数据集比如lerobot/aloha_mobile_cabinet把名字当参数传进训练脚本就能开跑。给你的第一条路线先用 ACT 这种小策略跑通lerobot-train确认训练流程没问题接上自己的硬件用遥操作录数据用自己的数据集微调模型LeRobot 核心能力逐个看统一机器人接口一个类控制所有硬件SO-100 小机械臂、Unitree G1 人形机器人、Koch 平台在 LeRobot 里都是同一个Robot接口你的代码只需要调三类方法connect()建立连接、get_observation()读传感器和相机、send_action(action)下发动作。硬件差异被封装在接口之下换平台时训练和部署代码基本不用改。硬件类别代表机型典型用途低成本机械臂SO-100 / SO-101桌面操作任务学习轮式操作平台LeKiwi、HopeJR、Koch移动操作与数据采集人形 / 全尺寸Unitree G1、Reachy2全身控制实验遥操作设备SO-101 主臂、键盘、手柄、手机录制演示数据清单里没有你的设备社区维护着插件机制包名以lerobot_robot_开头的包会被自动发现装完就能在命令里直接使用接入方式参考硬件集成指南。LeRobotDataset v3机器人数据的一种标准格式这是 LeRobot 最容易被低估的部分。别的框架数据各存各的私有格式这里统一成三样东西数据存储格式特点多路相机画面MP4 视频按相机分片同一 episode 的帧拼进同一个文件状态、动作、时间戳Parquet低维高频信号内存映射快速加载episode 索引、任务描述元数据文件按元数据定位不再靠文件名代码里就是LeRobotDataset(lerobot/aloha_mobile_cabinet)一行视频解码、帧对齐全由框架处理。数据量大了还有StreamingLeRobotDataset不下载直接从 Hub 流式读取。删 episode、拆分、合并数据集这些脏活也有现成工具格式细节见数据集文档。现成策略库从 ACT 到 VLApolicies 源码目录用纯 PyTorch 实现了主流算法按用途分四类模仿学习ACT、Diffusion、VQ-BeTVLA 视觉-语言-动作模型Pi0、Pi0.5、GR00T N1.7、SmolVLA强化学习TDMPC、HIL-SERL世界模型与奖励模型VLA-JEPA、SARM、TOPReward近两年最热门的是 VLA 系列用预训练的视觉-语言模型抽特征融合机器人本体状态再迭代生成动作序列。结构长这样每个策略都有单独文档如 ACT、Pi0显存需求和预期训练时长汇总在硬件指南。lerobot-eval先仿真后真机部署前先验证策略好不好先在仿真基准上跑几集看看命令长这样lerobot-eval \ --policy.pathlerobot/pi0_libero_finetuned \ --env.typelibero \ --env.tasklibero_object \ --eval.n_episodes10基准环境类型适合验证什么LIBERO厨房操作VLA 策略的操作成功率MetaWorld通用操作模仿学习策略横向对比RoboCasa / RoboMME家居、长程任务复杂场景与多阶段任务环境接入方式可以参考 LIBERO 基准文档。实战场景用 SO-101 录数据、训策略、上真机新手最常见的配置一对 SO-101 机械臂主臂遥操作、从臂执行。输入两个串口如/dev/ttyACM0、/dev/ttyACM1、两台 USB 相机、一个 Hugging Face 账号数据集会传到 Hub。先跑一次lerobot-calibrate完成标定记住用的id后面所有命令都要保持一致。配置第一步录数据边动主臂边按下表参数执行lerobot-record \ --robot.typeso101_follower \ --robot.port/dev/ttyACM0 \ --robot.cameras{ top: {type: opencv, index_or_path: 1, width: 640, height: 480, fps: 30}, wrist: {type: opencv, index_or_path: 0, width: 640, height: 480, fps: 30} } \ --teleop.typeso101_leader \ --teleop.port/dev/ttyACM1 \ --dataset.repo_id${HF_USER}/so101_demo \ --dataset.num_episodes30 \ --dataset.single_taskput the red brick in a bowl录制过程中按右方向键保存当前 episode左方向键删除重录ESC 结束并上传。第二步训练lerobot-train \ --dataset.repo_id${HF_USER}/so101_demo \ --policy.typeact \ --policy.devicecuda \ --steps20000ACT 是小模型单张消费级显卡几个小时能跑完没有 GPU 就加--job.targeta10g-small放到远端算。结果训练完的模型用lerobot-rollout --policy.path${HF_USER}/my_policy --robot.typeso101_follower --taskput the red brick in a bowl --duration60在从臂上跑起来。注意这里的相机配置必须和录制时一字不差模型读到的输入才会对得上。这条流程的每个参数都能查到详细解释推荐直接跟 SO-101 教程 走一遍。避坑对照5 个常见问题与解法现象原因解法连不上机器人串口找不到USB 驱动没装或端口指错跑lerobot-find-port确认端口再用--robot.port指定相机打不开或画面不对相机索引发生变化跑lerobot-find-cameras确认真实索引训练时视频解码报错ffmpeg 缺失或版本不匹配conda install ffmpeg -c conda-forge详见安装文档rollout 行为异常或直接崩溃运行时相机配置与录制时不一致核对--robot.cameras与录制命令完全相同本地卡上训练太慢模型大、显存不够换 SmolVLA 等小模型微调或参考多 GPU 训练指南把机器人学习从硬件工程题变成命令行题的就是 LeRobot数据有统一格式策略开箱即用离真机部署只差几条命令。建议从官方文档的教程部分开始社区讨论和贡献入口见 README。【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考