Desktop клиент и CLI

Desktop клиентот служи за снимање dataset-и со рака на вашето сопствено биро: го детектира хардверот, ве води низ чисто снимање на епизоди и сѐ чува локално додека самите не одлучите да прикачите. CLI-то доаѓа заедно со него и истовремено служи како MCP сервер.

Последно ажурирано 2026-08-09

Што прави desktop апликацијата

Кокпитот во прелистувачот е направен за далечинско управување со роботи што живеат на платформата. Desktop клиентот ја покрива другата половина од работниот тек: вие, рака на робот на вашето биро и dataset што сакате самите да го снимите. Се поврзува со раката преку USB, ги детектира приклучените камери и ве води низ снимањето, епизода по епизода.

Детекцијата е автоматска. Приклучете SO-100 и апликацијата го наоѓа серискиот порт и ги набројува сервомоторите; поврзаните веб-камери се појавуваат во преглед за да можете да ја проверите рамката пред да снимите нешто. Нема датотека за конфигурација што треба да се пишува и нема драјвер што треба да се бара.

Сѐ што снимате прво се запишува на локалниот диск. Ништо не го напушта вашиот компјутер додека изречно не прикачите, што е важно ако вашите епизоди содржат работи што сѐ уште не сте подготвени да ги споделите, или ако снимате некаде без стабилна врска.

Преземање и инсталација

Апликацијата е достапна за macOS, Windows и Linux на /download. Инсталирајте ја, најавете се со вашата сметка на платформата и поврзете ја раката. Ако во исто време спарувате робот со платформата, апликацијата е и местото каде го искористувате кодот за спарување од волшебникот.

Водено упатство за снимање

Снимањето добри податоци за imitation learning е претежно дисциплина, а апликацијата ја наметнува таа дисциплина наместо вас. Секоја епизода поминува низ истите пет станици.

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

    Една јасна реченица, формулирана на ист начин секој пат за истата задача. Language-conditioned policy обрнуваат внимание на овој текст, па „земи ја црвената коцка и стави ја во сад“ е подобро од „тест 4“.

  2. 2
    Ресетирајте ја сцената

    Поставете ја раката во почетна поза и распоредете ги предметите. Прегледот од камерата е тука за да ја потврдите рамката пред да започнете, а не откако веќе сте почнале.

  3. 3
    Снимајте

    Телеоперирајте ја раката низ задачата со намерни, мазни движења. Запрете штом задачата е завршена, наместо да стои во кадар без работа.

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

    Пуштете ја епизодата пред да ја задржите. Отфрлањето лоша епизода чини секунди; тренирањето врз неа чини часови.

  5. 5
    Прикачете

    Кога сте задоволни, прикачете ја серијата. Епизодите се појавуваат во прегледувачот на dataset-и на платформата, покрај сѐ што е снимено преку далечински сесии.

Локални податоци и извоз во LeRobot

Епизодите се чуваат и извезуваат во LeRobot формат, форматот за размена што го прифаќа најголемиот дел од отворениот екосистем за учење кај роботите. Dataset снимен со desktop клиентот може директно да оди во тренирање за ACT, Diffusion Policy, SmolVLA или GR00T fine-tune-ови.

GR00T бара LeRobot v2.1

Ако планирате fine-tune на GR00T, извезете го вашиот dataset како LeRobot v2.1. GR00T не прифаќа други верзии на dataset, а откривањето на ова по долга сесија на снимање не е забавно.

CLI-то

CLI-то се инсталира самостојно, без desktop апликацијата, што го прави правилен избор за машини без графички интерфејс и за скрипти. На macOS и Linux:

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

На Windows, во PowerShell:

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

CLI-то се автентицира со API-клуч. Создадете еден под /dashboard/settings; клучевите го носат префиксот ayr_live_ и треба да се третираат како лозинки, па чувајте ги во опкружувањето на вашата школка или во менаџер на тајни, а не во скрипти што ги комитирате.

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

Ако работите со асистент или уредувач кој поддржува MCP, платформата е достапна преку Model Context Protocol на два начина. Локалниот сервер работи на вашата машина и се стартува со една команда:

sh
ay-robots mcp
Стартувајте го локалниот MCP сервер

Хостираниот сервер се наоѓа на https://www.ay-robots.com/api/mcp и зборува Streamable HTTP. Не бара локална инсталација: насочете го вашиот MCP клиент кон URL-то и автентицирајте се со API-клуч со префикс ayr_live_ од /dashboard/settings за да работите со податоците на вашата сметка.

Локален MCP серверХостиран MCP сервер
Како се стартуваay-robots mcp по инсталирање на CLI-тоНема што да се стартува, поврзете се на https://www.ay-robots.com/api/mcp
ТранспортЛокален процес, стартуван од вашиот MCP клиентStreamable HTTP
АвтентикацијаВашите CLI акредитивиAPI-клуч со префикс ayr_live_
Погоден заРаботни текови кои допираат до вашата локална машина и хардверПодатоци од сметката од секаде, без инсталација

Често поставувани прашања

Дали снимањето работи офлајн?

Да. Снимањето е целосно локално. Ви треба поврзување за почетната најава и спарување, и повторно кога прикачувате, но не додека снимате епизоди.

Кои раце ги детектира desktop клиентот?

SO-100 (SO-ARM100) е главната рака и работи веднаш по приклучувањето. Погледнете ја страницата за роботи за целосната листа на поддржани типови на платформата.

Каде да добијам API-клуч?

Под /dashboard/settings. Клучевите започнуваат со ayr_live_ и дозволуваат пристап до вашата сметка, па чувајте ги како лозинки и повлечете секој клуч што можеби сте го изложиле.

Можам ли да го користам хостираниот MCP сервер без да инсталирам нешто?

Да. Зборува Streamable HTTP на https://www.ay-robots.com/api/mcp; ви треба само MCP клиент и API-клуч. Локалниот сервер е потребен само кога работниот тек го вклучува вашиот локален компјутер.