Десктопний клієнт і 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, щоб працювати з даними вашого акаунта.

Часті запитання