LeRobot 安装 5 步避坑指南依赖配置与硬件适配一次配通【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobotLeRobot 是一个面向真实世界机器人的 PyTorch 开源框架。安装它会踩 Python 版本、虚拟环境、依赖冲突、硬件驱动、最终验证五类坑本文带你按检查点一步步配通。安装路线图环境确认检查 Python 版本与系统虚拟环境用 conda 建一个隔离的 lerobot 环境依赖安装克隆仓库按用途装对应 extras设备连接装上电机、相机驱动并跑通通信自测验证用lerobot-info等命令验收检查点 1确认 Python 版本达标这一步只为排雷LeRobot 要求 Python 3.12 及以上版本偏低后面处处报错。python --version敲这条命令看当前 Python 版本。输出 3.12 或更高就能直接往下走低于 3.12 的话别急着装包下一步直接让 conda 帮你装一个 3.12 环境。如果你看到的是 3.10 或 3.11可以换用更高版本的 PythonUbuntu 用户可装 deadsnakes PPAmacOS 用户推荐 Homebrew更省事的做法是在下一个检查点用 conda 一步到位。检查点 2创建名为 lerobot 的虚拟环境这一步的目标把 LeRobot 的依赖和系统 Python 隔离开互不污染。conda create -y -n lerobot python3.12 conda activate lerobot第一条命令新建带 Python 3.12 的环境第二条激活它。怎么算过执行echo $CONDA_PREFIX输出的路径里包含lerobot才算激活成功。如果你看到激活后敲lerobot相关命令仍报command not found说明环境没生效——重新执行conda activate lerobot再用echo $CONDA_PREFIX复核一遍。如果建环境时报Solving environment timed out就改用国内镜像源或换 mamba 加速求解conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda install -c conda-forge mamba mamba create -y -n lerobot python3.12检查点 3克隆仓库并安装依赖先把代码拉到本地git clone https://gitcode.com/GitHub_Trending/le/lerobot cd lerobot然后按用途选装。做机器人操作录制、回放、标定装这个组合就够了pip install -e .[core_scripts]这条命令以可编辑模式安装 LeRobot并带上dataset、hardware、viz三组 extras。怎么算过命令正常结束无报错且后面能直接跑lerobot-info。要训练策略的话再补一条pip install -e .[training]不想操心 extras 就一把梭pip install -e .[all]。完整的 extras 清单以 pyproject.toml 为准。如果你看到 torch 和 torchvision 之间的VersionConflict别和 pip 硬刚按项目锁定的范围直接重装兼容版本pip install torch2.7,2.12.0 torchvision0.22.0,0.27.0如果安装av等包时编译失败、提示缺 cmake 或编译器就先装系统构建工具Ubuntusudo apt-get install cmake build-essential python3-dev pkg-config libavformat-dev libavcodec-dev视频解码依赖 ffmpeg环境里装一份conda install ffmpeg -c conda-forge装完执行ffmpeg -version能打印出版本号即算通过。检查点 4连接电机和相机这一步的目标让硬件能被 LeRobot 识别。没有实体硬件可以直接跳到下一关。电机驱动按品牌选装——SO100/SO101/Moss 用 FeetechKoch v1.1 用 Dynamixelpip install -e .[feetech] # Feetech 电机 pip install -e .[dynamixel] # Dynamixel 电机怎么算过装完跑一遍端口检测工具lerobot-find-port终端列出可用串口说明电机通信链路通了。如果你看到串口权限报错就执行sudo chmod 666 /dev/ttyUSB0换成你的实际端口名再试。用 RealSense 相机的话装上专用驱动pip install -e .[intelrealsense]再用lerobot-find-cameras验收输出里能看到相机型号即识别成功。电机就绪后还可以让工具自动扫一遍关节活动范围并生成配置lerobot-find-joint-limits --robot so100_follower看到逐关节的限位数值和生成的配置文件这关就算打通了。检查点 5一条命令完成自测最后一关给整个安装做体检。lerobot-info输出 LeRobot 版本号和系统环境信息基础安装就算全部成功。如果你看到command not found回到检查点 2 检查环境是否激活、包是否装进了这个环境。想再验证仿真链路可以装 pusht 环境并跑一个示例回放pip install -e .[pusht] python examples/lekiwi/replay.py仿真窗口里出现机器人执行动作的过程说明安装链路完全打通。排错路径VersionConflict: torch→ pip 解出了与 LeRobot 不兼容的 PyTorch 版本 → 按项目范围重装torch2.7,2.12.0与torchvision0.22.0,0.27.0conda 报Solving environment timed out→ 包求解太慢 → 换国内镜像源或改用 mamba 加速创建环境command not found: lerobot-info→ 环境没激活或装错了环境 → 重跑conda activate lerobot用echo $CONDA_PREFIX确认ModuleNotFoundError: No module named feetech→ 电机 extras 没装 →pip install -e .[feetech]Dynamixel 用户改装.[dynamixel]av编译失败、缺 libavcodec→ 系统缺 ffmpeg 库 →sudo apt-get install libavformat-dev libavcodec-dev串口 Permission denied→ 当前用户无串口访问权 →sudo chmod 666 /dev/ttyUSB0后重试装好 LeRobot 之后可以做什么通读官方安装与硬件接线文档docs/source/installation.mdx其余章节在 docs/动手跑 examples/ 里的示例遥操作录制、数据回放、策略训练需要具体策略算法SmolVLA、pi0 等时按 pyproject.toml 里的 extras 追加安装提示项目更新很快定期执行git pull origin main pip install -e .拉取最新修复。【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
LeRobot 安装 5 步避坑指南：依赖配置与硬件适配一次配通
LeRobot 安装 5 步避坑指南依赖配置与硬件适配一次配通【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobotLeRobot 是一个面向真实世界机器人的 PyTorch 开源框架。安装它会踩 Python 版本、虚拟环境、依赖冲突、硬件驱动、最终验证五类坑本文带你按检查点一步步配通。安装路线图环境确认检查 Python 版本与系统虚拟环境用 conda 建一个隔离的 lerobot 环境依赖安装克隆仓库按用途装对应 extras设备连接装上电机、相机驱动并跑通通信自测验证用lerobot-info等命令验收检查点 1确认 Python 版本达标这一步只为排雷LeRobot 要求 Python 3.12 及以上版本偏低后面处处报错。python --version敲这条命令看当前 Python 版本。输出 3.12 或更高就能直接往下走低于 3.12 的话别急着装包下一步直接让 conda 帮你装一个 3.12 环境。如果你看到的是 3.10 或 3.11可以换用更高版本的 PythonUbuntu 用户可装 deadsnakes PPAmacOS 用户推荐 Homebrew更省事的做法是在下一个检查点用 conda 一步到位。检查点 2创建名为 lerobot 的虚拟环境这一步的目标把 LeRobot 的依赖和系统 Python 隔离开互不污染。conda create -y -n lerobot python3.12 conda activate lerobot第一条命令新建带 Python 3.12 的环境第二条激活它。怎么算过执行echo $CONDA_PREFIX输出的路径里包含lerobot才算激活成功。如果你看到激活后敲lerobot相关命令仍报command not found说明环境没生效——重新执行conda activate lerobot再用echo $CONDA_PREFIX复核一遍。如果建环境时报Solving environment timed out就改用国内镜像源或换 mamba 加速求解conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda install -c conda-forge mamba mamba create -y -n lerobot python3.12检查点 3克隆仓库并安装依赖先把代码拉到本地git clone https://gitcode.com/GitHub_Trending/le/lerobot cd lerobot然后按用途选装。做机器人操作录制、回放、标定装这个组合就够了pip install -e .[core_scripts]这条命令以可编辑模式安装 LeRobot并带上dataset、hardware、viz三组 extras。怎么算过命令正常结束无报错且后面能直接跑lerobot-info。要训练策略的话再补一条pip install -e .[training]不想操心 extras 就一把梭pip install -e .[all]。完整的 extras 清单以 pyproject.toml 为准。如果你看到 torch 和 torchvision 之间的VersionConflict别和 pip 硬刚按项目锁定的范围直接重装兼容版本pip install torch2.7,2.12.0 torchvision0.22.0,0.27.0如果安装av等包时编译失败、提示缺 cmake 或编译器就先装系统构建工具Ubuntusudo apt-get install cmake build-essential python3-dev pkg-config libavformat-dev libavcodec-dev视频解码依赖 ffmpeg环境里装一份conda install ffmpeg -c conda-forge装完执行ffmpeg -version能打印出版本号即算通过。检查点 4连接电机和相机这一步的目标让硬件能被 LeRobot 识别。没有实体硬件可以直接跳到下一关。电机驱动按品牌选装——SO100/SO101/Moss 用 FeetechKoch v1.1 用 Dynamixelpip install -e .[feetech] # Feetech 电机 pip install -e .[dynamixel] # Dynamixel 电机怎么算过装完跑一遍端口检测工具lerobot-find-port终端列出可用串口说明电机通信链路通了。如果你看到串口权限报错就执行sudo chmod 666 /dev/ttyUSB0换成你的实际端口名再试。用 RealSense 相机的话装上专用驱动pip install -e .[intelrealsense]再用lerobot-find-cameras验收输出里能看到相机型号即识别成功。电机就绪后还可以让工具自动扫一遍关节活动范围并生成配置lerobot-find-joint-limits --robot so100_follower看到逐关节的限位数值和生成的配置文件这关就算打通了。检查点 5一条命令完成自测最后一关给整个安装做体检。lerobot-info输出 LeRobot 版本号和系统环境信息基础安装就算全部成功。如果你看到command not found回到检查点 2 检查环境是否激活、包是否装进了这个环境。想再验证仿真链路可以装 pusht 环境并跑一个示例回放pip install -e .[pusht] python examples/lekiwi/replay.py仿真窗口里出现机器人执行动作的过程说明安装链路完全打通。排错路径VersionConflict: torch→ pip 解出了与 LeRobot 不兼容的 PyTorch 版本 → 按项目范围重装torch2.7,2.12.0与torchvision0.22.0,0.27.0conda 报Solving environment timed out→ 包求解太慢 → 换国内镜像源或改用 mamba 加速创建环境command not found: lerobot-info→ 环境没激活或装错了环境 → 重跑conda activate lerobot用echo $CONDA_PREFIX确认ModuleNotFoundError: No module named feetech→ 电机 extras 没装 →pip install -e .[feetech]Dynamixel 用户改装.[dynamixel]av编译失败、缺 libavcodec→ 系统缺 ffmpeg 库 →sudo apt-get install libavformat-dev libavcodec-dev串口 Permission denied→ 当前用户无串口访问权 →sudo chmod 666 /dev/ttyUSB0后重试装好 LeRobot 之后可以做什么通读官方安装与硬件接线文档docs/source/installation.mdx其余章节在 docs/动手跑 examples/ 里的示例遥操作录制、数据回放、策略训练需要具体策略算法SmolVLA、pi0 等时按 pyproject.toml 里的 extras 追加安装提示项目更新很快定期执行git pull origin main pip install -e .拉取最新修复。【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考