使用LeKiwi机器人配合LeRobot框架的完整指南

使用LeKiwi机器人配合LeRobot框架的完整指南

概述

本文将详细介绍如何在LeRobot框架下使用LeKiwi移动机械臂系统。LeKiwi是一款开源的移动机械臂平台,结合LeRobot框架可以实现机器人控制、数据采集、模型训练等完整流程。我们将从硬件组装、软件配置到实际应用场景,逐步讲解整个使用流程。

硬件准备

部件清单

LeKiwi机器人主要由以下部件组成:

  1. 两个SO100机械臂(一个作为主控臂,一个作为执行臂)
  2. 移动底盘(包含三个驱动轮)
  3. 树莓派或其他计算设备
  4. 摄像头模块
  5. 电机控制板
  6. 3D打印结构件

建议按照官方提供的物料清单准备所有部件,并确保3D打印件的精度和质量。

软件安装

树莓派端配置

  1. 操作系统安装

    • 使用Raspberry Pi Imager工具安装Raspberry Pi OS或Ubuntu系统
    • 建议选择轻量级版本以减少资源占用
  2. SSH配置

    • 启用SSH服务以便远程访问
    • 配置静态IP地址方便后续连接
  3. LeRobot环境搭建

# 安装Miniconda
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-armv7l.sh
bash Miniconda3-latest-Linux-armv7l.sh

# 创建LeRobot环境
conda create -y -n lerobot python=3.10
conda activate lerobot

# 安装LeRobot及依赖
git clone https://github.com/huggingface/lerobot.git ~/lerobot
cd ~/lerobot && pip install -e ".[feetech]"

电脑端配置

电脑端配置与树莓派端类似,主要区别在于:

  • 无需配置SSH
  • 根据操作系统选择对应的Miniconda版本

硬件组装

电机配置

  1. 机械臂电机ID设置

    • 肩部平移电机:ID 1
    • 肩部升降电机:ID 2
    • 肘部电机:ID 3
    • 腕部电机:ID 4
    • 腕部旋转电机:ID 5
    • 夹爪电机:ID 6
  2. 移动底盘电机ID设置

    • 左轮电机:ID 7
    • 后轮电机:ID 8
    • 右轮电机:ID 9

端口识别

使用以下脚本识别电机控制板的USB端口:

python lerobot/scripts/find_motors_bus_port.py

脚本会指导你断开连接并重新连接USB设备,最终输出设备对应的端口号。

配置校准

执行臂校准

执行臂需要手动移动到三个特定位置进行校准:

  1. 零位姿势:所有关节处于初始位置
  2. 旋转姿势:各关节旋转一定角度
  3. 休息姿势:机械臂自然下垂位置

校准命令:

python lerobot/scripts/control_robot.py \
  --robot.type=lekiwi \
  --robot.cameras='{}' \
  --control.type=calibrate \
  --control.arms='["main_follower"]'

主控臂校准

主控臂校准流程与执行臂类似,同样需要移动到三个特定位置。

远程操作

配置完成后,可以使用键盘远程控制LeKiwi机器人:

  • W/S:前进/后退
  • A/D:左移/右移
  • Z/X:左转/右转
  • R/F:加速/减速
  • Q:退出控制模式

数据采集与训练

数据集录制

使用LeRobot框架可以方便地录制机器人操作数据:

python lerobot/scripts/record_episodes.py \
  --robot.type=lekiwi \
  --output_dir=./my_dataset

模型训练

使用采集的数据训练控制策略:

python lerobot/scripts/train.py \
  --policy.type=diffusion \
  --dataset.path=./my_dataset

策略评估

训练完成后可以评估策略性能:

python lerobot/scripts/eval.py \
  --policy.path=./my_policy

常见问题

  1. USB端口权限问题

    sudo chmod 666 /dev/ttyACM*
    
  2. 网络连接问题

    • 确保树莓派和电脑在同一网络
    • 检查网络设置
  3. 电机响应异常

    • 检查电源供应是否充足
    • 确认电机ID设置正确

结语

通过LeRobot框架,我们可以完整地实现从LeKiwi机器人控制到算法开发的整个流程。这套系统非常适合机器人学习、控制算法研究和实际应用开发。随着使用深入,可以尝试更多高级功能如多模态感知、强化学习等,充分发挥LeKiwi平台的潜力。

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

<think>好的,我需要帮用户解决如何通过镜像网站下载Hugging Face的le robot Git仓库的问题。首先,用户提到他们想使用镜像网站来下载,这可能是因为直接访问Hugging Face的主站速度较慢或者有地域限制。 首先,我得回忆一下Git镜像仓库的基本操作。通常,镜像仓库可以通过添加镜像URL作为远程仓库,然后进行克隆或者拉取。用户提供的示例引用了两个步骤,一个是克隆仓库,另一个是启动机器人的命令。用户可能已经尝试过直接克隆,但想通过镜像加速。 接下来,我需要确认Hugging Face是否有官方的镜像网站。据我所知,Hugging Face本身可能没有官方镜像,但有一些社区维护的镜像,比如使用HF Mirror(https://hf-mirror.com)。这个镜像常用于模型和数据集的下载,但不确定是否支持Git仓库的镜像。 如果镜像网站支持Git仓库,那么克隆命令可能需要替换URL中的域名部分。例如,原命令是`git clone https://github.com/huggingface/lerobot.git`,如果使用镜像,可能需要改为镜像的URL,比如`git clone https://hf-mirror.com/huggingface/lerobot.git`。但需要验证这个URL是否存在。 另外,Git本身支持通过`git clone`命令添加镜像参数,比如`--mirror`,但这通常用于创建本地镜像仓库,而不是从远程镜像下载。所以可能需要先添加镜像作为远程仓库,再从中拉取。 另一个方法是使用Git的配置来替换URL。例如,使用`git config`设置URL重写规则,将原始URL自动替换为镜像URL。例如: ``` git config --global url."https://hf-mirror.com/".insteadOf "https://huggingface.co/" ``` 这样,当用户克隆`https://huggingface.co/huggingface/lerobot`时,Git会自动使用镜像地址。但需要确认镜像网站是否实际存在对应的仓库路径。 还需要检查le robot仓库的正确路径。用户提供的示例中克隆的是GitHub上的仓库(github.com/huggingface/lerobot),而Hugging Face的主站是huggingface.co,所以可能存在混淆。如果le robot仓库实际上托管在GitHub上,那么镜像可能需要针对GitHub的镜像,比如使用https://github.com.cnpmjs.org/ 或者https://hub.fastgit.org/ 这样的镜像站点。 但用户的问题特别提到Hugging Face的仓库,所以可能需要区分GitHub和Hugging Face的不同镜像。例如,如果仓库在Hugging Face的Git托管服务上(类似于huggingface.co/username/repo),那么可能需要使用对应的镜像地址。例如,将huggingface.co替换为hf-mirror.com。 总结可能的步骤: 1. 确定le robot仓库的实际位置:是在GitHub还是Hugging Face的Git托管上。 2. 根据仓库位置选择合适的镜像站点。 3. 修改克隆命令中的URL,替换为镜像地址。 4. 或者配置Git全局替换,自动重定向到镜像。 例如,如果原命令是克隆GitHub的仓库,使用GitHub镜像: ``` git clone https://hub.fastgit.org/huggingface/lerobot.git ``` 或者如果使用Hugging Face的镜像: ``` git clone https://hf-mirror.com/huggingface/lerobot ``` 但需要确认这些镜像是否存在该仓库。 另外,用户提供的引用中提到了克隆仓库的命令是`git clone https://github.com/huggingface/lerobot.git`,所以仓库确实在GitHub上。因此,可能需要使用GitHub的镜像站点。 GitHub的常见镜像包括: - https://github.com.cnpmjs.org/ - https://hub.fastgit.org/ - https://gitclone.com/ 因此,用户可以将原命令中的github.com替换为镜像域名,例如: ``` git clone https://hub.fastgit.org/huggingface/lerobot.git ``` 或者使用gitclone.com的加速服务: ``` git clone https://gitclone.com/github.com/huggingface/lerobot.git ``` 此外,还可以通过配置Git的全局代理或者使用加速插件来提升下载速度,但用户明确要求使用镜像网站,所以优先考虑替换URL的方法。 在回答时,需要分步骤说明如何替换URL,或者配置Git的全局替换,并提供示例命令。同时提醒用户如果某个镜像不可用,可以尝试其他镜像站点。 最后,确保用户后续步骤,如进入目录和运行脚本,与原命令一致,无需更改。</think>要使用镜像网站下载Hugging Face的`lerobot`仓库,可以通过替换域名或配置Git重定向实现。以下是具体步骤: --- ### **方法一:直接替换URL中的域名** 1. **确定原始仓库地址** 原始命令为: ```bash git clone https://github.com/huggingface/lerobot.git ``` 此仓库托管在GitHub上,因此需要使用GitHub的镜像站点。 2. **选择镜像站点** 常用GitHub镜像域名包括: - `hub.fastgit.org` - `github.com.cnpmjs.org` - `gitclone.com` 3. **修改克隆命令** 将`github.com`替换为镜像域名,例如: ```bash git clone https://hub.fastgit.org/huggingface/lerobot.git ``` 或使用`gitclone.com`加速服务: ```bash git clone https://gitclone.com/github.com/huggingface/lerobot.git ``` --- ### **方法二:配置Git全局重定向** 1. **设置URL替换规则** 通过Git配置,自动将`github.com`替换为镜像域名: ```bash git config --global url."https://hub.fastgit.org/".insteadOf "https://github.com/" ``` 此后,所有`https://github.com/...`的请求会自动重定向到镜像站点。 2. **执行原始克隆命令** ```bash git clone https://github.com/huggingface/lerobot.git ``` Git会实际从镜像地址下载。 --- ### **后续操作** 克隆完成后,进入仓库目录并启动机器人(根据引用[2]): ```bash cd lerobot conda activate lerobot python lerobot/scripts/control_robot.py \ --robot.type=lekiwi \ --control.type=remote_robot ``` --- ### **注意事项** 1. 如果某个镜像不可用,尝试更换其他镜像域名。 2. 镜像站点可能存在同步延迟,若克隆失败可稍后重试。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

邹渝旺

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值