Skip to content
Bring technology into reality

Tech Blogs

LeRobot Project Runtime Environment Setup Guide

10 Apr 2025 0 comments

LeRobot Community Repository: https://github.com/huggingface/lerobot

1. Dependency Preparation

1.1 Install NVIDIA Graphics Drivers

Linux Users:
Refer to: Linux Ubuntu OS Install NVIDIA Driver Guide

Windows Users:
Download from official website: https://www.nvidia.com/en-us/drivers/

1.2 Install NVIDIA CUDA

Linux Users:
Refer to: Linux Ubuntu OS Install NVIDIA CUDA Guide

Windows Users:

  1. Verify driver version compatibility via official documentation:
    https://docs.nvidia.com/cuda/cuda-toolkit-release-notes/index.html
  2. Download corresponding version:
    https://developer.nvidia.com/cuda-downloads

1.3 Install Anaconda Python Environment

Linux Users:
Refer to: Linux Ubuntu Install Anaconda Guide

Windows Users:
Download from official website: https://www.anaconda.com/download


2. Configure LeRobot Runtime Environment

2.1 Clone LeRobot Repository

Repository: https://github.com/huggingface/lerobot

Method 1: Git Clone

git clone https://github.com/huggingface/lerobot.git

Method 2: Download ZIP Archive

ZIP download step 1 ZIP download step 2

2.2 Create Python Virtual Environment

1. Create conda environment:

conda create -y -n lerobot python=3.10

2. Activate environment:

conda activate lerobot

3. Install dependencies:

pip install --no-binary=av -e ".[feetech]"

Common Error

error: subprocess-exited-with-error
Error screenshot 1 Error screenshot 2

Solution

Install compilation dependencies:

sudo apt-get install -y ffmpeg libavformat-dev libavcodec-dev libavdevice-dev libavutil-dev libavfilter-dev libswscale-dev libswresample-dev
Dependency installation 1 Dependency installation 2

Retry installation:

pip install --no-binary=av -e ".[feetech]"
Successful installation

2.3 Environment Verification

Test port detection script:

# It's okay if drivers are not connected; just test if it can run.
python lerobot/scripts/find_motors_bus_port.py

Accept result:

Verification result
Prev post
Next post

Leave a comment

Please note, comments need to be approved before they are published.

Thanks for subscribing!

This email has been registered!

Shop the look

Choose options

Edit option

Choose options

this is just a warning
Login
Shopping cart
0 items