LeRobot documentation

LeRobot

You are viewing main version, which requires installation from source. If you'd like regular pip install, checkout the latest stable version (v0.6.0).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

LeRobot

LeRobot, Hugging Face Robotics Library

State-of-the-art machine learning for real-world robotics

🤗 LeRobot provides a hardware-agnostic, Python-native interface for controlling real robots - from affordable arms like the SO-ARM101 to full humanoids. Plus the tools to record, store, and share the datasets they generate. Every dataset uses the standardized LeRobotDataset format (synchronized video + action/state data) and can be streamed directly from the Hugging Face Hub.

🤗 On top of that data, LeRobot implements state-of-the-art policies - from lightweight imitation-learning models like ACT to large vision-language-action models like π₀ and SmolVLA - all trainable, shareable, and deployable with the same handful of CLI commands.

The goal: lower the barrier to entry for robotics, so that everyone can contribute to, and benefit from, shared datasets and pretrained models.

Discord X (Twitter) Hugging Face Hub
Reachy 2 Demo

How It Works

Teleoperate → Record → Train → Deploy

  1. Teleoperate - control the robot yourself (with a leader arm, keyboard, or phone) so it can learn from your movements.
  2. Record - each demonstration is saved as a dataset: synchronized camera video plus the actions you took.
  3. Train - a policy (the neural network that will control the robot) learns to imitate your demonstrations.
  4. Deploy - run the trained policy on the robot and watch it complete the task on its own.

Get Started

New here? Install LeRobot, then pick your path:

🔧 I have a robot

LeRobot supports a wide range of arms and mobile robots. Popular picks:

  • SO-101 - our flagship, low-cost arm
  • LeKiwi - a mobile base with an arm on top
  • Koch v1.1 - a long-time community favorite
  • or find yours under Robots in the sidebar

Once it's assembled and calibrated, record a dataset and train your first policy with the imitation learning tutorial - or skip the CLI entirely with LeLab, a browser GUI for the same workflow.

💻 No hardware yet

You can still train and evaluate policies without owning a robot:

🤝 I want to contribute

Start with the Contributing guide, then add a new policy or bring your own hardware.

Explore the Docs

Common Problems

Running into issues? A few of the most frequent ones:

  • Blurry or unusable camera footage - lighting matters more than resolution. See the Cameras guide.
  • Build or install errors (cmake, ffmpeg, CUDA) - see the Troubleshooting section of the Installation guide.
  • Not sure which policy fits your GPU - check the Compute & Hardware Guide.
  • Still stuck? Ask on Discord - the community (and the LeRobot team) is there to help.
Update on GitHub