Desktopový klient a CLI

Čo desktopová aplikácia robí

Kokpit v prehliadači je určený na vzdialené ovládanie robotov, ktoré žijú na platforme. Desktopový klient pokrýva druhú polovicu workflow: vy, robotické rameno na vašom stole a dataset, ktorý chcete nahrať sami. Pripája sa k ramenu cez USB, rozpoznáva pripojené kamery a prevádza vás nahrávaním epizóda po epizóde.

Rozpoznávanie je automatické. Zapojte SO-100 a aplikácia nájde sériový port a vymenuje servá; pripojené webkamery sa zobrazia v náhľade, takže si môžete pred nahrávaním overiť kompozíciu záberu. Žiadny konfiguračný súbor na písanie a žiadny ovládač na hľadanie.

Všetko, čo nahráte, sa najprv zapíše na lokálny disk. Nič neopustí váš počítač, kým výslovne nenahráte dáta na server, čo je dôležité, ak vaše epizódy obsahujú niečo, čo ešte nie ste pripravení zdieľať, alebo ak nahrávate niekde bez spoľahlivého pripojenia.

Stiahnutie a inštalácia

Aplikácia je dostupná pre macOS, Windows a Linux na /download. Nainštalujte ju, prihláste sa svojím účtom platformy a pripojte rameno. Ak zároveň párujete robota s platformou, aplikácia je aj miestom, kde uplatníte párovací kód zo sprievodcu.

Sprievodný postup nahrávania

Nahrávanie kvalitných dát pre imitačné učenie je z veľkej časti otázka disciplíny a aplikácia túto disciplínu za vás presadzuje. Každá epizóda prechádza rovnakými piatimi stanicami.

1. 1
   Opíšte úlohu

   Jedna jasná veta, formulovaná rovnako pri každom výskyte tej istej úlohy. Jazykovo podmienené policy sa riadia práve týmto reťazcom, takže „zdvihni červenú kocku a polož ju do misky" je lepšie ako „test 4".

2. 2
   Vynulujte scénu

   Presuňte rameno do východiskovej polohy a rozmiestnite objekty. Náhľad kamery je tu na to, aby ste si kompozíciu overili pred záväzným krokom, nie po ňom.

3. 3
   Nahrávajte

   Teleoperujte rameno cez úlohu s rozvážnymi, plynulými pohybmi. Zastavte hneď, ako je úloha hotová, namiesto toho, aby ste ostali nečinne stáť v zábere.

4. 4
   Prehrajte a skontrolujte

   Pred uložením si epizódu prehrajte. Zahodenie zlej epizódy stojí sekundy; trénovanie na nej stojí hodiny.

5. 5
   Nahrajte na server

   Keď ste spokojní, nahrajte dávku. Epizódy sa objavia vo vašom prehliadači datasetov na platforme spolu so všetkým, čo bolo nahrané cez vzdialené relácie.

Lokálne dáta a export do LeRobot

Epizódy sa ukladajú a exportujú vo formáte LeRobot, výmennom formáte, ktorý akceptuje väčšina open-source ekosystému pre robotické učenie. Dataset nahraný desktopovým klientom môže ísť priamo do trénovania pre ACT, Diffusion Policy, SmolVLA alebo doladenia GR00T.

CLI

CLI sa inštaluje samostatne, bez desktopovej aplikácie, čo z neho robí správnu voľbu pre bezhlavé počítače a skripty. Na macOS a Linuxe:

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

Na Windows, v PowerShelli:

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

CLI sa autentifikuje pomocou API kľúča. Vytvorte si ho v /dashboard/settings; kľúče majú predponu ayr_live_ a mali by ste s nimi zaobchádzať ako s heslami, takže ich uchovávajte vo svojom shell prostredí alebo v správcovi tajomstiev, nie v skriptoch, ktoré commitujete.

MCP: lokálny a hostovaný

Ak pracujete s asistentom alebo editorom, ktorý podporuje MCP, platforma je dostupná cez Model Context Protocol dvoma spôsobmi. Lokálny server beží na vašom počítači a spúšťa sa jediným príkazom:

ay-robots mcp

Hostovaný server beží na https://www.ay-robots.com/api/mcp a hovorí protokolom Streamable HTTP. Nevyžaduje žiadnu lokálnu inštaláciu: nasmerujte svojho klienta MCP na túto URL a autentifikujte sa API kľúčom ayr_live_ z /dashboard/settings, aby ste pracovali s dátami svojho účtu.

Časté otázky