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.

  1. 1
    Kuvaile 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".

  2. 2
    Palauta 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.

  3. 3
    Tallenna

    Teleoperoi käsivartta tehtävän läpi tarkoituksenmukaisilla, tasaisilla liikkeillä. Pysähdy heti kun tehtävä on valmis, älä jää seisomaan kuvaan.

  4. 4
    Tarkista

    Toista episodi ennen kuin säilytät sen. Huonon episodin hylkääminen vie sekunteja; sillä kouluttaminen maksaa tunteja.

  5. 5
    Lataa 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.

GR00T vaatii LeRobot v2.1:n

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:

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

Windowsilla, PowerShellissä:

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

CLI 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:

sh
ay-robots mcp
Käynnistä paikallinen MCP-palvelin

Hostattu 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-palvelinHostattu MCP-palvelin
Käyttöönottoay-robots mcp CLI:n asennuksen jälkeenEi mitään ajettavaa, yhdistä osoitteeseen https://www.ay-robots.com/api/mcp
SiirtotapaPaikallinen prosessi, MCP-klienttisi käynnistämäStreamable HTTP
TodennusCLI-tunnuksesiAPI-avain etuliitteellä ayr_live_
SopiiTyönkulkuihin, jotka koskevat paikallista konettasi ja laitteistoaTilidataan 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.