Настолен клиент и CLI

Какво прави настолното приложение

Кокпитът в браузъра е създаден за дистанционно управление на роботи, които живеят на платформата. Настолният клиент покрива другата половина от работния процес: вие, роботизирана ръка на бюрото ви и dataset, който искате да запишете сами. Той се свързва с ръката през USB, разпознава свързаните камери и ви превежда през записа епизод по епизод.

Разпознаването е автоматично. Включете SO-100 и приложението намира серийния порт и изброява сервомоторите; свързаните уеб камери се показват в преглед, така че можете да проверите кадъра, преди да запишете каквото и да е. Няма конфигурационен файл за писане и няма драйвер за търсене.

Всичко, което запишете, първо се записва на локалния диск. Нищо не напуска компютъра ви, преди изрично да качите данните, което е важно, ако епизодите ви съдържат неща, които все още не сте готови да споделите, или ако записвате някъде без надеждна връзка.

Изтегляне и инсталиране

Приложението е налично за macOS, Windows и Linux на /download. Инсталирайте го, влезте с акаунта си в платформата и свържете ръката. Ако едновременно сдвоявате робот с платформата, приложението е и мястото, откъдето използвате кода за сдвояване от съветника.

Направляваният процес на запис

Записването на добри данни за имитационно обучение е предимно въпрос на дисциплина, а приложението налага тази дисциплина вместо вас. Всеки епизод преминава през едни и същи пет стъпки.

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

   Едно ясно изречение, формулирано по един и същ начин всеки път за една и съща задача. Езиково обусловените policy обръщат внимание именно на този текст, така че „вдигни червеното кубче и го постави в купата" е по-добро от „тест 4".

2. 2
   Нулирайте сцената

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

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

   Телеоперирайте ръката през задачата с премерени, плавни движения. Спрете веднага щом задачата е изпълнена, вместо да стоите бездейно в кадър.

4. 4
   Прегледайте

   Прегледайте епизода, преди да го запазите. Изхвърлянето на лош епизод струва секунди; тренирането върху него струва часове.

5. 5
   Качете

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

Локални данни и износ към LeRobot

Епизодите се съхраняват и изнасят във формат LeRobot, обменния формат, който приема по-голямата част от общността с отворен код за роботизирано обучение. Dataset, записан с настолния клиент, може да отиде директно в трениране за 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_ и трябва да се третират като пароли, така че ги пазете в средата на shell-а си или в мениджър за тайни, а не в скриптове, които commit-вате.

MCP: локален и хостван

Ако работите с асистент или редактор, съвместим с MCP, платформата е достъпна през Model Context Protocol по два начина. Локалният сървър работи на вашия компютър и се стартира с една команда:

ay-robots mcp

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

Често задавани въпроси