# LeRobot

  
    <img alt="LeRobot, biblioteca de robótica de Hugging Face" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/lerobot/lerobot-logo-thumbnail.png"
    >
  

**Machine learning de última generación para robótica en el mundo real**

🤗 LeRobot ofrece una interfaz nativa de Python e independiente del hardware para controlar robots reales, desde brazos asequibles como el SO-ARM101 hasta humanoides completos. Además, incluye las herramientas para grabar, almacenar y compartir los conjuntos de datos que generan. Cada conjunto de datos utiliza el formato estandarizado **LeRobotDataset** (vídeo sincronizado + datos de acción/estado) y puede transmitirse directamente desde el [Hugging Face Hub](https://huggingface.co/lerobot).

🤗 Sobre esos datos, LeRobot implementa políticas de última generación: desde modelos ligeros de aprendizaje por imitación como ACT hasta grandes modelos de visión-lenguaje-acción como π₀ y SmolVLA, todos entrenables, compartibles y desplegables con el mismo puñado de comandos de CLI.

El objetivo: reducir la barrera de entrada a la robótica, para que todos puedan contribuir a, y beneficiarse de, conjuntos de datos y modelos preentrenados compartidos.

  
    
  
  
    
  
  
    
  

  

## Cómo funciona

**Teleoperar → Grabar → Entrenar → Desplegar**

1. **Teleoperar** - controla el robot tú mismo (con un brazo líder, un teclado o un teléfono) para que pueda aprender de tus movimientos.
2. **Record** - cada demostración se guarda como un conjunto de datos: el video de la cámara sincronizado junto con las acciones que realizaste.
3. **Entrenar** - una política (la red neuronal que controlará el robot) aprende a imitar tus demostraciones.
4. **Desplegar** - ejecutar la política entrenada en el robot y observar cómo completa la tarea por sí solo.

## Comenzar

¿Nuevo por aquí? Vea cómo es un conjunto de datos de LeRobot antes de instalar nada:

  <a target="_blank" href="https://huggingface.co/spaces/lerobot/visualize_dataset?path=/lerobot/svla_so101_pickplace/episode_0" class="shrink-0"
  >
    <img
      src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/lerobot/visualizer-episode-v2.webp"
      alt="The LeRobot Dataset Visualizer playing an SO-101 dataset"
      width="320"
    />
  
  
    👀 Ver un conjunto de datos primero
    
    
      Abre <a target="_blank" href="https://huggingface.co/spaces/lerobot/visualize_dataset?path=/lerobot/svla_so101_pickplace/episode_0"
      >lerobot/svla_so101_pickplace en <a
        target="_blank" href="https://huggingface.co/spaces/lerobot/visualize_dataset"
      >LeRobot Dataset Visualizer para ver sus grabaciones de cámara junto a
      estado y acciones del robot, cuadro a cuadro, sin necesidad de instalar nada. Funciona con cualquier conjunto de datos de LeRobot en el Hub, incluidos los tuyos. Consulta <a href="./using_dataset_tools#explore-a-dataset-in-the-browser"
      >cómo usarlo.
    
  

¿Listo para probarlo? [Instala LeRobot](./installation) y luego elige tu camino:

  
    🔧 Tengo un robot
    
      LeRobot es compatible con una amplia variedad de brazos y robots móviles. Opciones populares:
    
    
      
        SO-101 - nuestro brazo insignia de bajo costo
      
      
        LeKiwi - una base móvil con un brazo en la parte superior
      
      
        Koch v1.1 - un favorito de la comunidad desde hace mucho tiempo
      
      
        o busca el tuyo en Robots en la barra lateral
      
    
    
      Una vez que esté ensamblado y calibrado, registre un conjunto de datos y entrene su primera política con el tutorial de aprendizaje por imitación, o omita por completo la CLI con LeLab, una interfaz gráfica de navegador para el mismo flujo de trabajo.
    
  
  
    💻 Aún no hay hardware
    
      Aun así, puedes entrenar y evaluar políticas sin poseer un robot:
    
    
      
        explorar cualquier conjunto de datos en
        
          Visualizador de conjuntos de datos
        
      
      
        entrenar en un
        
          Conjunto de datos de LeRobot
        
        del Hub
      
      
        evaluar en simulación, frente a benchmarks como LIBERO o Meta-World
      
      
        prueba los notebooks de Colab gratuitos: no hay nada que instalar
      
    
  
  
    🤝 Quiero contribuir
    
      Comience con la guía de contribución y luego agregue una nueva política o utilice su propio hardware.
    
  

## Explora la documentación

  <a class="!no-underline border dark:border-gray-700 rounded-lg p-4 shadow hover:shadow-lg" href="./cheat-sheet"
  >
    📋 Hoja de trucos
    
      Todos los comandos de la CLI de LeRobot, listos para copiar y pegar.
    
  
  <a class="!no-underline border dark:border-gray-700 rounded-lg p-4 shadow hover:shadow-lg" href="./hardware_guide"
  >
    🖥️ Guía de cómputo y hardware
    
      Qué política se adapta a tu GPU y cuánto tiempo tarda el entrenamiento.
    
  
  <a class="!no-underline border dark:border-gray-700 rounded-lg p-4 shadow hover:shadow-lg" href="./lerobot-dataset-v3"
  >
    🗂️ LeRobotDataset
    
      Carga, transmite y visualiza conjuntos de datos de robots desde el Hub.
    
  
  <a class="!no-underline border dark:border-gray-700 rounded-lg p-4 shadow hover:shadow-lg" href="./lelab"
  >
    🖼 LeLab
    
      Una interfaz gráfica de navegador para calibrar, grabar y entrenar, sin necesidad de CLI.
    
  
  <a class="!no-underline border dark:border-gray-700 rounded-lg p-4 shadow hover:shadow-lg" href="./act"
  >
    🧠 Políticas
    
      Comience con ACT, nuestra primera política recomendada, o explore SmolVLA, π₀ y más en la barra lateral.
    
  
  <a class="!no-underline border dark:border-gray-700 rounded-lg p-4 shadow hover:shadow-lg" href="./libero"
  >
    🎮 Simulación y pruebas de rendimiento
    
      Entrena y evalúa en benchmarks simulados como LIBERO antes de trabajar con hardware real.
    
  

## Problemas comunes

¿Tienes problemas? Algunos de los más frecuentes:

- **Grabación borrosa o inutilizable de la cámara** - la iluminación es más importante que la resolución. Consulta [Colocación de la cámara e iluminación](./cameras#camera-placement-and-lighting).
- **Errores de compilación o instalación** (`cmake`, `ffmpeg`, CUDA): consulte la sección de Solución de problemas de la [Guía de instalación](./installation#troubleshooting).
- **¿No está seguro de qué política se adapta a su GPU?** Consulte la [Guía de cómputo y hardware](./hardware_guide).
- **¿Sigues atascado?** Pregunta en [Discord](https://discord.gg/s3KuuzsPFb): la comunidad (y el equipo de LeRobot) está ahí para ayudarte.

