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.

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

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

  3. 3
    Neem 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.

  4. 4
    Hersien

    Speel die episode terug voordat jy dit behou. Om 'n swak episode te verwerp, kos sekondes; om daarop op te lei, kos ure.

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

GR00T benodig LeRobot v2.1

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:

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

Op Windows, in PowerShell:

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

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

sh
ay-robots mcp
Begin die plaaslike MCP-bediener

Die 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-bedienerGehuisveste MCP-bediener
Hoe om te loopay-robots mcp na installasie van die CLINiks om te loop nie, koppel aan https://www.ay-robots.com/api/mcp
VervoerPlaaslike proses, deur jou MCP-kliënt gelanseerStreamable HTTP
VerifikasieJou CLI-geloofsbrieweAPI-sleutel met die ayr_live_-voorvoegsel
Goed virWerkvloeie wat jou plaaslike masjien en hardeware raakRekeningdata 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.