К содержимому
Робототехника

pi05-agilex3-2bit

2-bit квантованная версия π0.5 для манипулятора AgileX Piper

2 мин чтенияобновлено

Модель pi05-agilex3-2bit от автора ForeverBlue представляет собой 2-bit квантованную (сжатую по точности весов) версию модели agilex3_pi05 (полнопараметрический файнтюн π0.5 на трёх задачах манипуляции, шаг 5999 EMA) на базе библиотеки openpi. Она предназначена для тестирования на реальном роботе AgileX Piper и сравнения точности с полноточным вариантом: интерфейсы ввода-вывода, команды и частота управления 10 Hz полностью идентичны оригиналу. Квантование выполнено только методом калибровки (на 256 наблюдениях из демонстраций с аугментациями освещения и обрезки) без дополнительного дообучения, а сами веса сохранены в распакованном виде в стандартный формат PyTorch (model.safetensors), чтобы запускаться в штатном окружении openpi без правки кода.

Ключевые особенности

  • Агрессивное 2-bit квантование: все 414 линейных слоёв в визуальном энкодере, языковой модели и модуле действий (2,7 млрд параметров) сжаты в среднем до 2,016 бита на вес, а таблица эмбеддингов переведена в INT8.
  • Полная совместимость с openpi: модель использует те же статистики нормализации norm_stats.json и подключается к существующим скриптам agilex3_pi05.py простой сменой пути в параметре --checkpoint.
  • Близость к оригиналу: отклонение предсказаний 2-bit версии от полноточной модели всего в 1,2 раза превышает естественный разброс самого оригинала при смене начального шума.
  • Два режима интеграции: поддерживается как прямой вызов политики из Python-кода робота, так и запуск через локальный policy server по сети.

Что можно сделать

  • Провести A/B-тесты на реальном AgileX Piper: поочерёдно запускать полноточную и 2-bit модели на трёх задачах (cluster_grasp, cabinet_lemon, circle) при одинаковой расстановке объектов для оценки реального процента успеха.
  • Собрать данные для следующей калибровки: записать потоки с двух камер, состояния и команды во время работы 2-bit модели, чтобы использовать их для улучшения последующих версий квантования.

Пример

import os; os.environ.setdefault("JAX_PLATFORMS", "cpu")
import sys; sys.path.insert(0, "/path/to/agilex3_pi05")
from agilex3_pi05 import AgileXPi05Policy

policy = AgileXPi05Policy(checkpoint="/path/to/pi05-agilex3-2bit/checkpoint")
actions = policy.predict(fixed, wrist, state, instruction)  # (10, 7)
ПодробнееОфлайн-тесты (256 отложенных наблюдений): средняя ошибка суставов выросла с 0,0168 rad у полноточной модели до 0,0237 rad (17% от ошибки неподвижного состояния), ошибка захвата — с 2,31 мм до 3,16 мм, максимальное отклонение на шаг — 0,217 rad.
Размер файла model.safetensors составляет 14,5 ГБ (распакованные веса для совместимости с PyTorch; реальный объём 2-bit слоёв — 0,68 ГБ против 5,41 ГБ в BF16, но специализированный рантайм в репозиторий не входит).
Перед запуском требуется применить патч transformers_replace для transformers 4.53.2 и задать JAX_PLATFORMS=cpu.
Первый вызов predict запускает компиляцию torch.compile (около 472 секунд на RTX 6000 Ada), после чего медианное время инференса составляет 0,067 с.
Обсудить Telegram 0

Запустится ли?

Считаем требования к памяти

Бот ещё собирает размеры весов этой модели — оценка появится здесь через несколько минут. Пока можно арендовать видеокарту с запасом.

Massed ComputeОткрыть Massed Compute

Запуск на Massed Compute

Скрипт скачает модель на арендованную машину. Как её запустить — в карточке модели.

  1. 1. Арендуйте машину с подходящей видеокартой

    Открыть Massed Compute
  2. 2. Вставьте скрипт в терминал машины

    Подключитесь по SSH (команда есть в панели Massed Compute) или откройте терминал на рабочем столе машины.

    HF_TOKEN / CIVITAI_TOKENВ начале скрипта строки для токенов: вставьте свой между кавычками. Токен Hugging Face нужен для закрытых моделей, токен Civitai — для моделей с Civitai.

    # ForeverBlue/pi05-agilex3-2bit
    # ===== Токены: вставьте свои между кавычками =====
    export HF_TOKEN=""        # huggingface.co/settings/tokens — для закрытых моделей
    # ==========================================
    mkdir -p ~/models
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    uv tool install "huggingface_hub[cli]"
    hf download ForeverBlue/pi05-agilex3-2bit --local-dir ~/models/pi05-agilex3-2bit
    # Модель в папке ~/models. Как её запускать, написано в карточке модели (ссылка выше).
    Добавить ещё LoRA к pi05-agilex3-2bit
  3. 3. Пользуйтесь

    Модель в папке ~/models. Как её запускать, написано в карточке модели (ссылка выше).

Не забудьте остановить машину в панели, когда закончите: оплата идёт поминутно, пока она включена.

Как ускорить

Подобрано под тип модели. Выберите своё железо в блоке выше — покажем то, что подходит именно вам.

  • FlashAttention 44.0.0b40от 18 ноября 2026новая версия

    самое быстрое точное внимание на B200

    Ядра для Blackwell (пока бета). Точное внимание без квантования — подходит для всего, включая LLM.

    Как включить: pip install flash-attn-4; vLLM и SGLang подхватывают сами.

    Предыдущие поколения (2)
    • FlashAttention 3 — Версия для Hopper (H100/H200) с FP8.
    • FlashAttention 2 — Стандарт для RTX 30/40/50 и A100: точное внимание без лишней памяти на длинных контекстах.
  • torch.compile2.15.0от 28 октября 2026новая версия

    10–30% бесплатно

    Компилирует модель под вашу видеокарту. Первый запуск дольше, дальше быстрее.

    Как включить: model = torch.compile(model); в ComfyUI — узел TorchCompileModel.

Семья модели

Новые посты про версии pi05-agilex3-2bit — сжатые, дообучения, LoRA — появятся в колокольчике.

У этой модели пока нет известных родственников. Все производные на Hugging Face

О модели

ForeverBlue/pi05-agilex3-2bit
Автор
ForeverBlue
Категория
Робототехника
Дата выхода
На сайте

На сайте

Hugging Face

00

Спросить нейросеть об этой модели

Отвечает Gemini 4 · переписка хранится только в этой вкладке

Комментарии

Робототехника

track_v3_dual-image

track_v3_dual-image