Desktop client en CLI
Die desktop client is vir die opname van datastelle met 'n arm op jou eie lessenaar: dit bespeur die hardeware, lei jou deur skoon episode-vaslegging, en hou alles plaaslik totdat jy besluit om op te laai. Die CLI word saam daarmee gelewer en dien ook as 'n MCP-bediener.
Laas bygewerk 2026-08-09
Wat die desktopprogram doen
Die blaaier-cockpit is gebou vir afgeleë beheer van robotte wat op die platform leef. Die desktop client dek die ander helfte van die werkvloei: jy, 'n robotarm op jou lessenaar, en 'n datastel wat jy self wil opneem. Dit koppel via USB aan die arm, bespeur die aangeslote kameras, en lei jou episode vir episode deur die opnameproses.
Bespeuring is outomaties. Prop 'n SO-100 in en die program vind die seriepoort en tel die servo's; gekoppelde webkameras verskyn in 'n voorskou sodat jy inkadrering kan nagaan voordat jy enigiets opneem. Daar is geen konfigurasielêer om te skryf en geen drywer om te soek nie.
Alles wat jy opneem, word eers na plaaslike skyf geskryf. Niks verlaat jou masjien totdat jy uitdruklik oplaai nie, wat saak maak as jou episodes dinge bevat waarvoor jy nog nie gereed is om te deel nie, of as jy êrens sonder 'n betroubare verbinding opneem.
Laai af en installeer
Die program is beskikbaar vir macOS, Windows, en Linux by /download. Installeer dit, meld aan met jou platformrekening, en koppel die arm. As jy terselfdertyd 'n robot aan die platform koppel, is die program ook waar jy die koppelkode van die assistent gebruik.
Die geleide opnamevloei
Om goeie imitation learning-data op te neem, is meestal dissipline, en die program dwing daardie dissipline namens jou af. Elke episode loop deur dieselfde vyf stasies.
- 1Beskryf die taak
Een duidelike sin, elke keer op dieselfde manier vir dieselfde taak geformuleer. Taalgekondisioneerde policys let op hierdie string, dus is "tel die rooi kubus op en plaas dit in die bak" beter as "toets 4".
- 2Stel die toneel terug
Beweeg die arm na sy beginhouding en plaas die voorwerpe. Die kameravoorskou is daar sodat jy inkadrering kan bevestig voordat jy vasgemaak, nie daarna nie.
- 3Neem op
Teleopereer die arm deur die taak met doelbewuste, gladde bewegings. Stop sodra die taak voltooi is in plaas daarvan om in die beeld te talm.
- 4Hersien
Speel die episode terug voordat jy dit behou. Om 'n swak episode te verwerp, kos sekondes; om daarop op te lei, kos ure.
- 5Laai op
Wanneer jy tevrede is, laai die bondel op. Episodes verskyn in jou datastel-blaaier op die platform, saam met enigiets wat deur afgeleë sessies opgeneem is.
Plaaslike data en LeRobot-uitvoer
Episodes word in LeRobot-formaat gestoor en uitgevoer, die uitruilformaat wat die meeste van die oopbron-robot learning-ekosisteem aanvaar. 'n Datastel wat met die desktop client opgeneem is, kan direk in opleiding vir ACT, Diffusion Policy, SmolVLA, of GR00T fine-tunes ingaan.
As jy van plan is om GR00T fine-tune, voer jou datastel as LeRobot v2.1 uit. GR00T aanvaar geen ander datastelweergawe nie, en om dit ná 'n lang opnamesessie uit te vind, is nie pret nie.
Die CLI
Die CLI installeer op sy eie, sonder die desktopprogram, wat dit die regte keuse maak vir koplose masjiene en skripte. Op macOS en Linux:
curl -fsSL https://www.ay-robots.com/install.sh | shOp Windows, in PowerShell:
irm https://www.ay-robots.com/install.ps1 | iexDie CLI verifieer met 'n API-sleutel. Skep een onder /dashboard/settings; sleutels dra die ayr_live_-voorvoegsel en moet soos wagwoorde behandel word, hou hulle dus in jou shell-omgewing of 'n geheimebestuurder in plaas van in skripte wat jy commit.
MCP: plaaslik en gehuisves
As jy met 'n MCP-bevoegde assistent of redigeerder werk, is die platform op twee maniere bereikbaar via die Model Context Protocol. Die plaaslike bediener loop op jou eie masjien en word met een opdrag gestart:
ay-robots mcpDie gehuisveste bediener leef by https://www.ay-robots.com/api/mcp en praat Streamable HTTP. Dit benodig geen plaaslike installasie nie: rig jou MCP-kliënt na die URL en verifieer met 'n ayr_live_-API-sleutel van /dashboard/settings om met jou rekeningdata te werk.
| Plaaslike MCP-bediener | Gehuisveste MCP-bediener | |
|---|---|---|
| Hoe om te loop | ay-robots mcp na installasie van die CLI | Niks om te loop nie, koppel aan https://www.ay-robots.com/api/mcp |
| Vervoer | Plaaslike proses, deur jou MCP-kliënt gelanseer | Streamable HTTP |
| Verifikasie | Jou CLI-geloofsbriewe | API-sleutel met die ayr_live_-voorvoegsel |
| Goed vir | Werkvloeie wat jou plaaslike masjien en hardeware raak | Rekeningdata van enige plek, sonder installasie |
Gereelde vrae
Werk opname vanlyn?▾
Ja. Opname is heeltemal plaaslik. Jy benodig konnektiwiteit vir die aanvanklike aanmelding en koppeling, en weer wanneer jy oplaai, maar nie terwyl jy episodes vaslê nie.
Watter arms bespeur die desktop client?▾
Die SO-100 (SO-ARM100) is die primêre arm en werk direk uit die boks. Sien die robotte-bladsy vir die volledige lys van ondersteunde tipes op die platform.
Waar kry ek 'n API-sleutel?▾
Onder /dashboard/settings. Sleutels begin met ayr_live_ en gee toegang tot jou rekening, stoor hulle dus soos wagwoorde en herroep enige sleutel wat jy moontlik blootgestel het.
Kan ek die gehuisveste MCP-bediener gebruik sonder om iets te installeer?▾
Ja. Dit praat Streamable HTTP by https://www.ay-robots.com/api/mcp; al wat jy nodig het, is 'n MCP-kliënt en 'n API-sleutel. Die plaaslike bediener is slegs nodig wanneer die werkvloei jou plaaslike masjien behels.
Hoe AY-Robots teleoperasie-opnames in die LeRobot-formaat stoor: episodestruktuur, die dashboard se episode-blaaier, samevoeging van oplaaie, en die mark.
Skep 'n AY-Robots-rekening, kies die kliënt- of operateurrol, stel jou eerste omgewing op, koppel 'n robot met 'n koppelkode, en laat jou eerste sessie loop.