1. 项目概述
LeRobot是一个由HuggingFace推出的开源机器人学习框架,旨在通过端到端学习让机器人AI更加易于使用。这个框架特别适合想要快速上手机器人编程和机器学习的研究人员和开发者。我在实际使用过程中发现,虽然官方文档提供了基本指导,但在具体实施时还是会遇到不少坑。本文将分享从环境搭建到实际操作的完整流程,以及我在这个过程中积累的经验教训。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与安装
2.1 基础环境配置
首先需要安装Anaconda来管理Python环境。我强烈建议在创建环境时就明确指定版本号,这样可以避免后续版本冲突问题:
bash复制conda create -y -n lerobot0.3.3 python=3.10
conda activate lerobot0.3.3
conda install ffmpeg -c conda-forge
这里有几个关键点需要注意:
- 环境命名中包含版本号(lerobot0.3.3),这在后续多版本共存时特别有用
- 提前安装ffmpeg是为了处理视频数据
- 使用Python 3.10是因为这是当前最稳定的兼容版本
2.2 源码获取与依赖安装
克隆LeRobot仓库并安装依赖:
bash复制git clone https://github.com/huggingface/lerobot.git
cd lerobot
pip install -e .
pip install -e ".[all]"
pip install -e ".[aloha,pusht]"
pip install -e ".[feetech]"
这里有几个安装选项需要注意:
.[all]:安装所有可选依赖.[aloha,pusht]:安装特定机器人模型的依赖.[feetech]:安装舵机控制相关依赖
重要提示:执行
pip install lerobot会安装PyTorch的CPU版本,如果你需要使用GPU加速,需要先卸载这个版本,然后安装与你的CUDA驱动匹配的GPU版本。
2.3 GPU环境配置
检查CUDA版本:
bash复制nvidia-smi
根据显示的CUDA版本安装对应的PyTorch,例如对于CUDA
