Десктопный клиент и CLI

Что делает десктопное приложение

Кокпит в браузере создан для удалённого управления роботами, которые живут на платформе. Десктопный клиент закрывает другую половину рабочего процесса: вас, руку робота на вашем столе и датасет, который вы хотите записать самостоятельно. Он подключается к руке по USB, обнаруживает подключённые камеры и ведёт вас через запись эпизод за эпизодом.

Обнаружение автоматическое. Подключите SO-100, и приложение найдёт последовательный порт и перечислит серво; подключённые веб-камеры появляются в предпросмотре, чтобы вы могли проверить кадр до начала записи. Писать конфигурационный файл или искать драйвер не нужно.

Всё, что вы записываете, сначала сохраняется на локальный диск. Ничего не покидает вашу машину, пока вы явно не загрузите данные, что важно, если ваши эпизоды содержат то, чем вы пока не готовы делиться, или если вы записываете там, где нет надёжного соединения.

Скачивание и установка

Приложение доступно для macOS, Windows и Linux на /download. Установите его, войдите под своим аккаунтом на платформе и подключите руку. Если вы одновременно подключаете робота к платформе, в этом же приложении применяется код сопряжения из мастера.

Управляемый сценарий записи

Записывать хорошие данные для imitation learning значит прежде всего соблюдать дисциплину, и приложение соблюдает эту дисциплину за вас. Каждый эпизод проходит через одни и те же пять этапов.

1. 1
   Опишите задачу

   Одно чёткое предложение, сформулированное одинаково каждый раз для одной и той же задачи. Policy, обусловленные языком, обращают внимание именно на эту строку, поэтому «взять красный кубик и положить его в миску» лучше, чем «тест 4».

2. 2
   Сбросьте сцену

   Переместите руку в исходную позу и расставьте объекты. Предпросмотр камеры существует для того, чтобы вы проверили кадр до начала записи, а не после.

3. 3
   Записывайте

   Проведите руку через задачу телеоперацией, плавными и осознанными движениями. Останавливайтесь, как только задача выполнена, вместо того чтобы бездействовать в кадре.

4. 4
   Просмотрите

   Проиграйте эпизод перед тем, как сохранить его. Отбросить плохой эпизод стоит секунд; обучение на нём стоит часов.

5. 5
   Загрузите

   Когда всё устраивает, загрузите пакет. Эпизоды появятся в браузере датасетов на платформе рядом со всем, что записано через удалённые сессии.

Локальные данные и экспорт в LeRobot

Эпизоды хранятся и экспортируются в формате LeRobot, формате обмена, который принимает большая часть открытой экосистемы robot learning. Датасет, записанный десктопным клиентом, можно сразу использовать для обучения ACT, Diffusion Policy, SmolVLA или дообучения GR00T.

CLI

CLI устанавливается отдельно, без десктопного приложения, что делает его правильным выбором для машин без графического интерфейса и для скриптов. На macOS и Linux:

curl -fsSL https://www.ay-robots.com/install.sh | sh

На Windows, в PowerShell:

irm https://www.ay-robots.com/install.ps1 | iex

CLI аутентифицируется с помощью API-ключа. Создайте его в /dashboard/settings; ключи несут префикс ayr_live_ и должны обрабатываться как пароли, поэтому храните их в переменных окружения оболочки или в менеджере секретов, а не в скриптах, которые вы коммитите.

MCP: локально и в облаке

Если вы работаете с ассистентом или редактором, поддерживающим MCP, платформа доступна по Model Context Protocol двумя способами. Локальный сервер работает на вашей машине и запускается одной командой:

ay-robots mcp

Хостируемый сервер живёт по адресу https://www.ay-robots.com/api/mcp и говорит по Streamable HTTP. Локальная установка не нужна: укажите вашему MCP-клиенту этот URL и аутентифицируйтесь API-ключом ayr_live_ из /dashboard/settings, чтобы работать с данными вашего аккаунта.

Частые вопросы