Modelo fundacional abierto de visión, lenguaje y acción de NVIDIA (GR00T N1.7) para habilidades generalistas de manipulación con humanoides y robots, con herramientas de ajuste fino y despliegue.
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
Crea y activa un entorno conda con Python 3.10
conda create --name wallx python=3.10 - 2
Instala los requisitos
pip install -r requirements.txt - 3
Instala Wall-X, que compila los operadores CUDA
MAX_JOBS=8 pip install --no-build-isolation -e . - 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
Biblioteca de PyTorch con modelos, conjuntos de datos y herramientas para robótica en el mundo real: control de hardware, recopilación de datos, entrenamiento y evaluación de políticas.
Modelos VLA de robótica de código abierto de Physical Intelligence, con checkpoints preentrenados y ejemplos de fine-tuning.
Kit open source de brazo robótico líder-seguidor con 5 DOF y una pinza, piezas imprimibles en 3D y disposición de articulaciones compatible con LeRobot para teleoperación y aprendizaje por imitación.
Framework de simulación a gran escala, basado en robosuite, para entrenar y evaluar robots generalistas en tareas cotidianas de cocina.
Benchmark de aprendizaje por imitación para el control de cuerpo completo, con entornos MuJoCo y MJX para humanoides, cuadrúpedos y modelos musculoesqueléticos humanos.