Repolode
X-Square-Robot

X-Square-Robot/wall-x

Código de entrenamiento e inferencia para WALL-OSS, una serie de modelos fundacionales open source y encarnados para la manipulación robótica de propósito general.

Estrellas
1,313
Forks
111
Issues abiertos
52
Último commit
hace 2 meses

¿Qué es?

Wall-X es el código base de entrenamiento e inferencia de la serie WALL de modelos fundacionales encarnados, cuyo objetivo es dotar a los robots de habilidades de manipulación de propósito general aprendidas a partir de datos de interacción física. Abarca todo el flujo de trabajo, desde preparar conjuntos de datos en formato LeRobot y configurar modelos hasta ajustarlos, ejecutar inferencias y servir un modelo para evaluaciones en bucle cerrado o abierto.

El repositorio admite varias ramas de generación de acciones, incluidos los cabezales de acciones flow-matching y FAST, y ofrece checkpoints preentrenados de la familia WALL-OSS en Hugging Face. El entrenamiento se inicia con un entrenador FSDP y la inferencia puede exponerse mediante un servidor WebSocket. También hay disponible, como configuración opcional, una herramienta auxiliar para evaluar en el simulador LIBERO.

El proyecto está dirigido a Python 3.10 con PyTorch, FlashAttention y CUDA 12.x en Ubuntu 22.04. El código fuente de sus operadores CUDA se compila durante la instalación, por lo que se necesita un entorno funcional para compilar con GPU.

Funciones clave

  • 01Ajusta modelos con conjuntos de datos en formato LeRobot mediante un entrenador FSDP.
  • 02Admite ramas de generación de acciones flow-matching y FAST.
  • 03Carga checkpoints preentrenados de WALL-OSS alojados en Hugging Face.
  • 04Sirve acciones del modelo mediante un servidor WebSocket.
  • 05Incluye evaluación en bucle abierto con datos de referencia de LeRobot y scripts para iniciar el simulador LIBERO.

Casos de uso

  • Ajustar un modelo visión-lenguaje-acción con un conjunto de datos personalizado de manipulación robótica.
  • Ejecutar inferencias con un modelo encarnado preentrenado en un robot real o en una simulación.
  • Comparar predicciones de acciones en bucle abierto con demostraciones grabadas.
  • Investigar cabezales de acciones flow-matching o FAST para políticas robóticas.

Inicio rápido

  1. 1

    Crea y activa un entorno conda con Python 3.10

    conda create --name wallx python=3.10
  2. 2

    Instala los requisitos

    pip install -r requirements.txt
  3. 3

    Instala Wall-X, que compila los operadores CUDA

    MAX_JOBS=8 pip install --no-build-isolation -e .
  4. 4

    Ejecuta el ejemplo mínimo de inferencia con un checkpoint descargado

    python scripts/fake_inference.py --checkpoint-path <path/to/checkpoint>

Antes de usarlo

  • Requiere una GPU NVIDIA con CUDA; durante la instalación se compilan los operadores CUDA y flash-attn.
  • La configuración es compleja: hay que instalar manualmente varias dependencias, como LeRobot, DMuon y flash-attn.
  • El README está pensado para Ubuntu 22.04 con CUDA 12.x y Python 3.10.

En colecciones

Temas

Preguntas frecuentes

¿Qué es wall-x?
Código de entrenamiento e inferencia para WALL-OSS, una serie de modelos fundacionales open source y encarnados para la manipulación robótica de propósito general. Wall-X es el código base de entrenamiento e inferencia de la serie WALL de modelos fundacionales encarnados, cuyo objetivo es dotar a los robots de habilidades de manipulación de propósito general aprendidas a partir de datos de interacción física. Abarca todo el flujo de trabajo, desde preparar conjuntos de datos en formato LeRobot y configurar modelos hasta ajustarlos, ejecutar inferencias y servir un modelo para evaluaciones en bucle cerrado o abierto.
¿wall-x es gratuito? ¿Qué licencia tiene?
wall-x es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿wall-x sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de wall-x fue el 18 sept 2026.
¿Para qué puedo usar wall-x?
Ajustar un modelo visión-lenguaje-acción con un conjunto de datos personalizado de manipulación robótica. Ejecutar inferencias con un modelo encarnado preentrenado en un robot real o en una simulación. Comparar predicciones de acciones en bucle abierto con demostraciones grabadas. Investigar cabezales de acciones flow-matching o FAST para políticas robóticas.
¿Cómo se instala wall-x?
Crea y activa un entorno conda con Python 3.10: conda create --name wallx python=3.10 Instala los requisitos: pip install -r requirements.txt Instala Wall-X, que compila los operadores CUDA: MAX_JOBS=8 pip install --no-build-isolation -e . Ejecuta el ejemplo mínimo de inferencia con un checkpoint descargado: python scripts/fake_inference.py --checkpoint-path <path/to/checkpoint>
¿Dónde consigo wall-x?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/X-Square-Robot/wall-x

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados