Desktopklient og CLI

Hvad desktopappen gør

Cockpittet i browseren er bygget til fjernstyring af robotter, der lever på platformen. Desktopklienten dækker den anden halvdel af arbejdsgangen: dig, en robotarm på dit skrivebord og et datasæt, du selv vil optage. Den forbinder til armen via USB, registrerer de tilsluttede kameraer og guider dig gennem optagelse episode for episode.

Registreringen er automatisk. Sæt en SO-100 i, så finder appen serieporten og opregner servoerne; tilsluttede webcams vises i en forhåndsvisning, så du kan tjekke billedudsnittet, før du optager noget. Der er ingen konfigurationsfil at skrive og ingen driver at lede efter.

Alt, du optager, skrives først til den lokale disk. Intet forlader din maskine, før du eksplicit uploader, hvilket betyder noget, hvis dine episoder indeholder ting, du ikke er klar til at dele, eller hvis du optager et sted uden en pålidelig forbindelse.

Download og installer

Appen findes til macOS, Windows og Linux på /download. Installer den, log ind med din platformskonto, og tilslut armen. Parrer du samtidig en robot til platformen, er appen også der, hvor du indløser parringskoden fra guiden.

Det guidede optagelsesforløb

At optage gode data til imitationslæring handler mest om disciplin, og appen håndhæver disciplinen for dig. Hver episode gennemløber de samme fem stationer.

1. 1
   Beskriv opgaven

   Én klar sætning, formuleret på samme måde hver gang for samme opgave. Sprogbetingede policyer lægger vægt på denne streng, så "pick up the red cube and place it in the bowl" slår "test 4".

2. 2
   Nulstil scenen

   Flyt armen til dens startposition, og placer objekterne. Kameraforhåndsvisningen er der, så du kan bekræfte billedudsnittet, før du forpligter dig, ikke bagefter.

3. 3
   Optag

   Teleoperér armen gennem opgaven med bevidste, jævne bevægelser. Stop, så snart opgaven er fuldført, i stedet for at stå stille i billedet.

4. 4
   Gennemgå

   Afspil episoden, før du beholder den. At kassere en dårlig episode koster sekunder; at træne på den koster timer.

5. 5
   Upload

   Når du er tilfreds, uploader du batchen. Episoder dukker op i din datasætbrowser på platformen sammen med alt, der er optaget gennem fjernsessioner.

Lokale data og LeRobot-eksport

Episoder gemmes og eksporteres i LeRobot-format, det udvekslingsformat, som størstedelen af det open source-baserede økosystem for robotlæring accepterer. Et datasæt optaget med desktopklienten kan gå direkte til træning for ACT, Diffusion Policy, SmolVLA eller GR00T-finjusteringer.

CLI'et

CLI'et installeres selvstændigt, uden desktopappen, hvilket gør det til det rette valg til headless-maskiner og scripts. På macOS og Linux:

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

På Windows, i PowerShell:

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

CLI'et autentificerer med en API-nøgle. Opret en under /dashboard/settings; nøgler har præfikset ayr_live_ og bør behandles som adgangskoder, så opbevar dem i din shell-miljø eller en secret manager i stedet for i scripts, du committer.

MCP: lokal og hostet

Arbejder du med en MCP-kompatibel assistent eller editor, kan platformen tilgås via Model Context Protocol på to måder. Den lokale server kører på din maskine og startes med én kommando:

ay-robots mcp

Den hostede server ligger på https://www.ay-robots.com/api/mcp og taler Streamable HTTP. Den kræver ingen lokal installation: peg din MCP-klient mod URL'en, og autentificer med en ayr_live_-API-nøgle fra /dashboard/settings for at arbejde med dine kontodata.

Ofte stillede spørgsmål