Открытая базовая vision-language-action-модель NVIDIA GR00T N1.7 для навыков управления гуманоидными роботами и манипуляции, с инструментами дообучения и развёртывания.
X-Square-Robot/wall-x
Код для обучения и инференса WALL-OSS — семейства открытых embodied foundation models для универсального управления манипуляциями роботов.
- Звёзды
- 1,313
- Форки
- 111
- Открытые issues
- 52
- Последний коммит
- 2 месяца назад
Что это?
Wall-X — кодовая база для обучения и инференса embodied foundation models серии WALL, предназначенных для освоения роботами универсальных навыков манипуляции на основе данных о физическом взаимодействии. Репозиторий охватывает весь процесс: подготовку датасетов в формате LeRobot, настройку моделей, дообучение, запуск инференса и развёртывание модели для оценки с замкнутым или разомкнутым контуром.
Репозиторий поддерживает несколько вариантов генерации действий, в том числе action heads на основе flow matching и FAST, а также предоставляет предварительно обученные чекпойнты семейства WALL-OSS на Hugging Face. Обучение запускается с помощью FSDP trainer, а инференс можно предоставлять через WebSocket-сервер. В качестве дополнительной настройки доступен инструмент для оценки в симуляторе LIBERO.
Проект рассчитан на Python 3.10, PyTorch, FlashAttention и CUDA 12.x в Ubuntu 22.04. Исходный код CUDA-операторов компилируется при установке, поэтому нужна рабочая среда для сборки с GPU.
Ключевые возможности
- 01Дообучает модели на датасетах в формате LeRobot с помощью FSDP trainer.
- 02Поддерживает варианты генерации действий на основе flow matching и FAST.
- 03Загружает предварительно обученные чекпойнты WALL-OSS с Hugging Face.
- 04Предоставляет действия модели через WebSocket-сервер.
- 05Включает оценку с разомкнутым контуром по эталонным данным LeRobot и средства запуска симулятора LIBERO.
Сценарии использования
- Дообучение vision-language-action модели на собственном датасете для управления манипуляциями робота.
- Запуск инференса с предварительно обученной embodied-моделью на реальном роботе или в симуляции.
- Сравнение прогнозов действий с разомкнутым контуром с записанными демонстрациями.
- Исследование action heads на основе flow matching или FAST для роботизированных политик.
Быстрый старт
- 1
Создайте и активируйте окружение conda с Python 3.10
conda create --name wallx python=3.10 - 2
Установите зависимости
pip install -r requirements.txt - 3
Установите Wall-X, который компилирует CUDA-операторы
MAX_JOBS=8 pip install --no-build-isolation -e . - 4
Запустите минимальный пример инференса с загруженным чекпойнтом
python scripts/fake_inference.py --checkpoint-path <path/to/checkpoint>
Что важно знать
- Требуется NVIDIA GPU с поддержкой CUDA; при установке компилируются CUDA-операторы и flash-attn.
- Настройка сложная: несколько зависимостей, например LeRobot, DMuon и flash-attn, нужно устанавливать вручную.
- README рассчитан на Ubuntu 22.04 с CUDA 12.x и Python 3.10.
В подборках
Темы
Частые вопросы
- Что такое wall-x?
- Код для обучения и инференса WALL-OSS — семейства открытых embodied foundation models для универсального управления манипуляциями роботов. Wall-X — кодовая база для обучения и инференса embodied foundation models серии WALL, предназначенных для освоения роботами универсальных навыков манипуляции на основе данных о физическом взаимодействии. Репозиторий охватывает весь процесс: подготовку датасетов в формате LeRobot, настройку моделей, дообучение, запуск инференса и развёртывание модели для оценки с замкнутым или разомкнутым контуром.
- wall-x можно использовать бесплатно? Какая у него лицензия?
- wall-x распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- wall-x всё ещё поддерживается?
- Обновлялся за последние 6 месяцев. Последний коммит в wall-x — 18 сент. 2026 г..
- Для чего можно использовать wall-x?
- Дообучение vision-language-action модели на собственном датасете для управления манипуляциями робота. Запуск инференса с предварительно обученной embodied-моделью на реальном роботе или в симуляции. Сравнение прогнозов действий с разомкнутым контуром с записанными демонстрациями. Исследование action heads на основе flow matching или FAST для роботизированных политик.
- Как установить wall-x?
- Создайте и активируйте окружение conda с Python 3.10: conda create --name wallx python=3.10 Установите зависимости: pip install -r requirements.txt Установите Wall-X, который компилирует CUDA-операторы: MAX_JOBS=8 pip install --no-build-isolation -e . Запустите минимальный пример инференса с загруженным чекпойнтом: python scripts/fake_inference.py --checkpoint-path <path/to/checkpoint>
- Где скачать wall-x?
- Исходный код и инструкции по установке — на GitHub: https://github.com/X-Square-Robot/wall-x
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Библиотека PyTorch с моделями, датасетами и инструментами для робототехники в реальных условиях: управление оборудованием, сбор данных, обучение и оценка политик.
Открытые VLA-модели для робототехники от Physical Intelligence: предобученные чекпойнты и примеры дообучения.
Набор для сборки робота-манипулятора «ведущий — ведомый» с открытой конструкцией: 5 степеней свободы и захват, детали для 3D-печати и совместимая с LeRobot компоновка суставов.
Масштабный симуляционный фреймворк на базе robosuite для обучения роботов-универсалов бытовым кухонным задачам и их бенчмаркинга.
Бенчмарк имитационного обучения для управления всем телом с окружениями MuJoCo и MJX для гуманоидов, четвероногих роботов и биомеханических моделей человека.