Työpöytäsovellus ja CLI
Työpöytäsovellus on tarkoitettu datasetien tallentamiseen omalla pöydälläsi olevalla käsivarrella: se tunnistaa laitteiston, opastaa sinut siistin episodien tallennuksen läpi ja pitää kaiken paikallisena, kunnes päätät ladata sen pilveen. CLI tulee mukana ja toimii myös MCP-palvelimena.
Viimeksi päivitetty 2026-08-09
Mitä työpöytäsovellus tekee
Selaimen ohjaamo on rakennettu alustalla elävien robottien etäohjaukseen. Työpöytäsovellus kattaa työnkulun toisen puoliskon: sinut, pöydälläsi olevan robottikäsivarren ja datasetin, jonka haluat tallentaa itse. Se yhdistää käsivarteen USB:n kautta, tunnistaa liitetyt kamerat ja opastaa sinut tallennuksessa episodi kerrallaan.
Tunnistus on automaattinen. Kytke SO-100 kiinni, niin sovellus löytää sarjaportin ja luettelee servot; liitetyt web-kamerat näkyvät esikatselussa, jotta voit tarkistaa rajauksen ennen kuin tallennat mitään. Konfiguraatiotiedostoa ei tarvitse kirjoittaa eikä ajuria etsiä.
Kaikki tallentamasi kirjoitetaan ensin paikalliselle levylle. Mikään ei poistu koneeltasi, ennen kuin lataat sen nimenomaisesti pilveen, mikä on tärkeää, jos episodisi sisältävät asioita, joita et ole vielä valmis jakamaan, tai jos tallennat paikassa, jossa ei ole luotettavaa yhteyttä.
Lataa ja asenna
Sovellus on saatavilla macOS:lle, Windowsille ja Linuxille osoitteessa /download. Asenna se, kirjaudu sisään alustatililläsi ja yhdistä käsivarsi. Jos pariutat samalla robottia alustaan, sovelluksesta myös lunastetaan velhon pariutuskoodi.
Ohjattu tallennuskulku
Hyvän imitaatio-oppimisdatan tallentaminen on enimmäkseen kurinalaisuutta, ja sovellus pitää kurin puolestasi. Jokainen episodi kulkee läpi samat viisi vaihetta.
- 1Kuvaile tehtävä
Yksi selkeä lause, muotoiltuna samalla tavalla joka kerta samaa tehtävää varten. Kieliehdolliset policyt kiinnittävät huomionsa tähän merkkijonoon, joten "pick up the red cube and place it in the bowl" voittaa merkkijonon "test 4".
- 2Palauta näkymä alkuun
Siirrä käsivarsi aloitusasentoonsa ja aseta esineet paikoilleen. Kameran esikatselu on siellä, jotta voit varmistaa rajauksen ennen sitoutumista, ei sen jälkeen.
- 3Tallenna
Teleoperoi käsivartta tehtävän läpi tarkoituksenmukaisilla, tasaisilla liikkeillä. Pysähdy heti kun tehtävä on valmis, älä jää seisomaan kuvaan.
- 4Tarkista
Toista episodi ennen kuin säilytät sen. Huonon episodin hylkääminen vie sekunteja; sillä kouluttaminen maksaa tunteja.
- 5Lataa pilveen
Kun olet tyytyväinen, lataa erä pilveen. Episodit ilmestyvät datasetselaimeesi alustalla, muiden etäistuntojen kautta tallennettujen episodien joukkoon.
Paikallinen data ja LeRobot-vienti
Episodit tallennetaan ja viedään LeRobot-muodossa, joka on vaihtomuoto, jonka suurin osa avoimen lähdekoodin robottioppimisen ekosysteemistä hyväksyy. Työpöytäsovelluksella tallennettu dataset voi mennä suoraan koulutukseen ACT:lle, Diffusion Policylle, SmolVLA:lle tai GR00T-hienosäädöille.
Jos aiot hienosäätää GR00T:ta, vie datasetisi LeRobot v2.1 -muodossa. GR00T ei hyväksy muita datasetversioita, eikä sen huomaaminen pitkän tallennusistunnon jälkeen ole hauskaa.
CLI
CLI asentuu itsenäisesti, ilman työpöytäsovellusta, mikä tekee siitä oikean valinnan headless-koneille ja skripteille. macOS:lla ja Linuxilla:
curl -fsSL https://www.ay-robots.com/install.sh | shWindowsilla, PowerShellissä:
irm https://www.ay-robots.com/install.ps1 | iexCLI todentaa API-avaimella. Luo sellainen osoitteessa /dashboard/settings; avaimissa on etuliite ayr_live_, ja niitä pitäisi käsitellä kuin salasanoja, joten säilytä niitä shell-ympäristössäsi tai salaisuuksienhallinnassa, älä skripteissä, jotka committaat versionhallintaan.
MCP: paikallinen ja hostattu
Jos työskentelet MCP-yhteensopivan avustajan tai editorin kanssa, alusta on tavoitettavissa Model Context Protocolin kautta kahdella tavalla. Paikallinen palvelin toimii koneellasi ja käynnistyy yhdellä komennolla:
ay-robots mcpHostattu palvelin sijaitsee osoitteessa https://www.ay-robots.com/api/mcp ja puhuu Streamable HTTP:tä. Se ei vaadi paikallista asennusta: osoita MCP-klienttisi URL-osoitteeseen ja todenna ayr_live_-API-avaimella osoitteesta /dashboard/settings, niin pääset käsiksi tilisi dataan.
| Paikallinen MCP-palvelin | Hostattu MCP-palvelin | |
|---|---|---|
| Käyttöönotto | ay-robots mcp CLI:n asennuksen jälkeen | Ei mitään ajettavaa, yhdistä osoitteeseen https://www.ay-robots.com/api/mcp |
| Siirtotapa | Paikallinen prosessi, MCP-klienttisi käynnistämä | Streamable HTTP |
| Todennus | CLI-tunnuksesi | API-avain etuliitteellä ayr_live_ |
| Sopii | Työnkulkuihin, jotka koskevat paikallista konettasi ja laitteistoa | Tilidataan mistä tahansa, ei asennusta |
Usein kysytyt kysymykset
Toimiiko tallennus offline-tilassa?▾
Kyllä. Tallennus on täysin paikallista. Tarvitset yhteyden alkukirjautumiseen ja pariutukseen sekä uudelleen ladatessasi, mutta et episodeja tallentaessasi.
Mitkä käsivarret työpöytäsovellus tunnistaa?▾
SO-100 (SO-ARM100) on ensisijainen käsivarsi ja toimii suoraan pakkauksesta. Katso robottisivulta täydellinen lista alustalla tuetuista tyypeistä.
Mistä saan API-avaimen?▾
Osoitteesta /dashboard/settings. Avaimet alkavat etuliitteellä ayr_live_ ja antavat pääsyn tilillesi, joten säilytä niitä kuin salasanoja ja peruuta jokainen avain, jonka olet saattanut paljastaa.
Voinko käyttää hostattua MCP-palvelinta asentamatta mitään?▾
Kyllä. Se puhuu Streamable HTTP:tä osoitteessa https://www.ay-robots.com/api/mcp; tarvitset vain MCP-klientin ja API-avaimen. Paikallinen palvelin tarvitaan vain, kun työnkulku koskee paikallista konettasi.
Näin AY-Robots tallentaa teleoperointitallenteet LeRobot-muodossa: episodirakenne, dashboardin episodiselain, latausten yhdistäminen ja markkinapaikka.
Luo AY-Robots-tili, valitse asiakkaan tai operaattorin rooli, luo ensimmäinen ympäristösi, pariuta robotti pariutuskoodilla ja aja ensimmäinen istuntosi.