Repolode
X-Square-Robot

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. 1

    Создайте и активируйте окружение conda с Python 3.10

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

    Установите зависимости

    pip install -r requirements.txt
  3. 3

    Установите Wall-X, который компилирует CUDA-операторы

    MAX_JOBS=8 pip install --no-build-isolation -e .
  4. 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 обновляется ежедневно.

Похожие проекты

Открытая базовая vision-language-action-модель NVIDIA GR00T N1.7 для навыков управления гуманоидными роботами и манипуляции, с инструментами дообучения и развёртывания.

8,3 тыс.+32 за неделю1,5 тыс.PythonApache-2.0Обновлён 21 час назад

Библиотека PyTorch с моделями, датасетами и инструментами для робототехники в реальных условиях: управление оборудованием, сбор данных, обучение и оценка политик.

28,7 тыс.+86 за неделю6 тыс.PythonApache-2.0Обновлён 20 часов назад

Набор для сборки робота-манипулятора «ведущий — ведомый» с открытой конструкцией: 5 степеней свободы и захват, детали для 3D-печати и совместимая с LeRobot компоновка суставов.

180+4 за неделю10CC-BY-4.0Активно поддерживаетсяОбновлён 9 часов назад