// GETTING STARTED

Set up your environment

Before building anything, you need the right tools. This guide covers LeRobot installation and environment setup. It is the foundation for Project 2 (arm) and Project 5 (data engine).

01

Install Miniforge (conda)

LeRobot recommends conda via miniforge to manage environments. Download and install:

wget "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3-$(uname)-$(uname -m).sh
02

Create Python Environment

Create and activate a virtual environment with Python 3.12:

conda create -y -n lerobot python=3.12
conda activate lerobot
03

Install ffmpeg

LeRobot uses TorchCodec for video decoding, which requires ffmpeg:

conda install ffmpeg -c conda-forge
04

Install LeRobot

Clone the repository and install with the extras you need:

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

# For robot workflows (recording, replaying, calibrate)
pip install -e ".[core_scripts]"

# For training policies
pip install -e ".[training]"

# Everything (all policies, envs, hardware, dev tools)
pip install -e ".[all]"
05

Install Motor Control SDK

For SO-ARM101, install the Feetech SDK:

pip install -e ".[feetech]"
06

Verify Installation

Test that LeRobot is installed correctly:

python -c "import lerobot; print(lerobot.__version__)"