Töölauaklient ja CLI

Töölauaklient on mõeldud andmestike salvestamiseks käsivarrega teie enda laual: see tuvastab riistvara, juhib teid läbi puhta episoodide jäädvustamise ja hoiab kõike lokaalselt, kuni otsustate üles laadida. Sellega kaasneb CLI, mis toimib ka MCP serverina.

Viimati uuendatud 2026-08-09

Mida töölauarakendus teeb

Brauseri kokpit on loodud platvormil elavate robotite kaugjuhtimiseks. Töölauaklient katab töövoo teise poole: teie, robotkäsivars teie laual ja andmestik, mida soovite ise salvestada. See ühendub käsivarrega USB kaudu, tuvastab ühendatud kaamerad ja juhib teid läbi salvestamise episood episoodi järel.

Tuvastamine on automaatne. Ühendage SO-100 ja rakendus leiab jadapordi ning loendab servomootorid; ühendatud veebikaamerad ilmuvad eelvaates, et saaksite enne salvestamist kontrollida kaadrit. Konfiguratsioonifaili ei pea kirjutama ja draiverit ei pea otsima.

Kõik, mida salvestate, kirjutatakse kõigepealt kohalikule kettale. Miski ei lahku teie masinast enne, kui te selgesõnaliselt üles laadite, mis on oluline, kui teie episoodides on midagi, millega te pole veel valmis jagama, või kui salvestate kohas ilma usaldusväärse ühenduseta.

Allalaadimine ja paigaldamine

Rakendus on saadaval macOS, Windowsi ja Linuxi jaoks aadressil /download. Paigaldage see, logige sisse oma platvormi kontoga ja ühendage käsivars. Kui seote samal ajal robotit platvormiga, on see rakendus ka koht, kus kasutate viisardist saadud sidumiskoodi.

Juhitud salvestusprotsess

Heade imitatsioonõppe andmete salvestamine on peamiselt distsipliin ja rakendus tagab selle distsipliini teie eest. Iga episood läbib samad viis etappi.

  1. 1
    Kirjeldage ülesannet

    Üks selge lause, iga kord sama ülesande jaoks samamoodi sõnastatud. Keelel põhinevad policy-d pööravad tähelepanu sellele stringile, seega "pick up the red cube and place it in the bowl" on parem kui "test 4".

  2. 2
    Lähtestage stseen

    Viige käsivars algasendisse ja paigutage esemed. Kaamera eelvaade on seal, et kinnitada kaadrit enne salvestamist, mitte pärast.

  3. 3
    Salvestage

    Teleopereerige käsivart läbi ülesande sihikindlate, sujuvate liigutustega. Peatuge kohe, kui ülesanne on täidetud, mitte ärge seiske jõude kaadris.

  4. 4
    Vaadake üle

    Esitage episood enne selle säilitamist. Halva episoodi kõrvaleheitmine maksab sekundeid; sellega treenimine maksab tunde.

  5. 5
    Laadige üles

    Kui olete rahul, laadige partii üles. Episoodid ilmuvad teie andmestike vaataja platvormil, koos kõige muuga, mis on salvestatud kaugseansside kaudu.

Kohalikud andmed ja LeRobot eksport

Episoodid salvestatakse ja eksporditakse LeRobot formaadis, vahetusformaadis, mida aktsepteerib suurem osa avatud lähtekoodiga robotite õppimise ökosüsteemist. Töölauakliendiga salvestatud andmestik saab minna otse treeningusse ACT, Diffusion Policy, SmolVLA või GR00T fine-tune jaoks.

GR00T vajab LeRobot v2.1

Kui plaanite teha GR00T fine-tune'i, eksportige oma andmestik kui LeRobot v2.1. GR00T ei aktsepteeri teisi andmestiku versioone ning selle avastamine pärast pikka salvestusseanssi ei ole meeldiv.

CLI

CLI paigaldub iseseisvalt, ilma töölauarakenduseta, mis teeb sellest õige valiku ekraanita masinatele ja skriptidele. macOS ja Linuxi jaoks:

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

Windowsis, PowerShellis:

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

CLI autendib end API võtmega. Looge see aadressil /dashboard/settings; võtmed kannavad eesliidet ayr_live_ ja neid tuleks käsitleda nagu paroole, seega hoidke neid keskkonnamuutujates või saladuste halduris, mitte skriptides, mille repositooriumisse esitate.

MCP: kohalik ja hostitud

Kui töötate MCP-võimekusega assistendi või redaktoriga, on platvorm saavutatav Model Context Protocol'i kaudu kahel viisil. Kohalik server töötab teie masinal ja käivitatakse ühe käsuga:

sh
ay-robots mcp
Käivitage kohalik MCP server

Hostitud server asub aadressil https://www.ay-robots.com/api/mcp ja räägib Streamable HTTP-d. See ei vaja kohalikku paigaldust: suunake oma MCP klient sellele URL-ile ja autentige end ayr_live_ API võtmega aadressilt /dashboard/settings, et töötada oma konto andmetega.

Kohalik MCP serverHostitud MCP server
Kuidas käivitadaay-robots mcp pärast CLI paigaldamistMidagi ei pea käivitama, ühenduge aadressiga https://www.ay-robots.com/api/mcp
TransportKohalik protsess, mille käivitab teie MCP klientStreamable HTTP
AutentimineTeie CLI mandaadidAPI võti ayr_live_ eesliitega
SobibTöövoogudele, mis puudutavad teie kohalikku masinat ja riistvaraKonto andmetele igalt poolt, ilma paigalduseta

Korduma kippuvad küsimused

Kas salvestamine töötab võrguühenduseta?

Jah. Salvestamine toimub täielikult lokaalselt. Ühendust on vaja esialgseks sisselogimiseks ja sidumiseks ning uuesti siis, kui üles laadite, kuid mitte episoodide jäädvustamise ajal.

Milliseid käsivarsi töölauaklient tuvastab?

SO-100 (SO-ARM100) on peamine käsivars ja töötab kohe. Vaadake robotite lehelt kõigi platvormil toetatud tüüpide täielikku loendit.

Kust ma saan API võtme?

Aadressilt /dashboard/settings. Võtmed algavad ayr_live_ ja annavad juurdepääsu teie kontole, seega hoidke neid nagu paroole ja tühistage iga võti, mille olete võib-olla avalikustanud.

Kas saan kasutada hostitud MCP serverit ilma midagi paigaldamata?

Jah. See räägib Streamable HTTP-d aadressil https://www.ay-robots.com/api/mcp; vaja on ainult MCP klienti ja API võtit. Kohalik server on vajalik ainult siis, kui töövoog puudutab teie kohalikku masinat.