Skrivebordsklient og CLI

Skrivebordsklienten er for å ta opp datasett med en arm på ditt eget skrivebord: den oppdager maskinvaren, veileder deg gjennom rent episodeopptak, og holder alt lokalt til du bestemmer deg for å laste opp. CLI-en følger med og fungerer også som en MCP-server.

Sist oppdatert 2026-08-09

Hva skrivebordsappen gjør

Cockpit i nettleseren er bygget for fjernstyring av roboter som lever på plattformen. Skrivebordsklienten dekker den andre halvparten av arbeidsflyten: deg, en robotarm på skrivebordet ditt, og et datasett du vil ta opp selv. Den kobler til armen over USB, oppdager tilkoblede kameraer og veileder deg gjennom opptak episode for episode.

Oppdagelsen er automatisk. Koble til en SO-100, og appen finner serieporten og lister opp servoene; tilkoblede webkameraer vises i en forhåndsvisning slik at du kan sjekke innramming før du tar opp noe. Ingen konfigurasjonsfil å skrive og ingen driver å lete etter.

Alt du tar opp, skrives først til lokal disk. Ingenting forlater maskinen din før du eksplisitt laster opp, noe som betyr noe hvis episodene dine inneholder ting du ikke er klar til å dele, eller hvis du tar opp et sted uten en pålitelig forbindelse.

Last ned og installer

Appen er tilgjengelig for macOS, Windows og Linux på /download. Installer den, logg inn med plattformkontoen din, og koble til armen. Parer du samtidig en robot med plattformen, er appen også der du løser inn paringskoden fra veiviseren.

Den veiledede opptaksflyten

Å ta opp gode data for imitasjonslæring handler mest om disiplin, og appen håndhever disiplinen for deg. Hver episode går gjennom de samme fem stasjonene.

  1. 1
    Beskriv oppgaven

    Én klar setning, formulert på samme måte hver gang for samme oppgave. Språkkondisjonerte policyer følger nøye med på denne strengen, så «plukk opp den røde kuben og legg den i skålen» slår «test 4».

  2. 2
    Nullstill scenen

    Flytt armen til startposisjonen og plasser objektene. Kameraforhåndsvisningen er der slik at du kan bekrefte innramming før du forplikter deg, ikke etterpå.

  3. 3
    Ta opp

    Teleoperer armen gjennom oppgaven med overlagte, jevne bevegelser. Stopp så snart oppgaven er fullført, i stedet for å ligge stille i bildet.

  4. 4
    Gjennomgå

    Spill av episoden før du beholder den. Å forkaste en dårlig episode koster sekunder; å trene på den koster timer.

  5. 5
    Last opp

    Når du er fornøyd, laster du opp batchen. Episodene dukker opp i datasett-utforskeren din på plattformen, sammen med alt som er tatt opp gjennom eksterne økter.

Lokale data og LeRobot-eksport

Episoder lagres og eksporteres i LeRobot-format, utvekslingsformatet det meste av det åpne robotlærings­økosystemet aksepterer. Et datasett tatt opp med skrivebordsklienten kan gå rett inn i trening for ACT, Diffusion Policy, SmolVLA eller GR00T-finjusteringer.

GR00T krever LeRobot v2.1

Planlegger du å finjustere GR00T, eksporter datasettet som LeRobot v2.1. GR00T aksepterer ikke andre datasettversjoner, og å oppdage det etter en lang opptaksøkt er ikke gøy.

CLI-en

CLI-en installeres frittstående, uten skrivebordsappen, noe som gjør den til det rette valget for hodeløse maskiner og skript. På macOS og Linux:

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

På Windows, i PowerShell:

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

CLI-en autentiserer med en API-nøkkel. Opprett en under /dashboard/settings; nøkler har prefikset ayr_live_ og bør behandles som passord, så oppbevar dem i skallmiljøet ditt eller en hemmelighetshåndterer, ikke i skript du committer.

MCP: lokal og hostet

Jobber du med en MCP-kompatibel assistent eller editor, er plattformen tilgjengelig over Model Context Protocol på to måter. Den lokale serveren kjører på maskinen din og startes med én kommando:

sh
ay-robots mcp
Start den lokale MCP-serveren

Den hostede serveren ligger på https://www.ay-robots.com/api/mcp og snakker Streamable HTTP. Den krever ingen lokal installasjon: pek MCP-klienten din mot URL-en og autentiser med en ayr_live_ API-nøkkel fra /dashboard/settings for å jobbe med kontodataene dine.

Lokal MCP-serverHostet MCP-server
Hvordan kjøreay-robots mcp etter installasjon av CLI-enIngenting å kjøre, koble til https://www.ay-robots.com/api/mcp
TransportLokal prosess, startet av MCP-klienten dinStreamable HTTP
AutentiseringCLI-legitimasjonen dinAPI-nøkkel med prefikset ayr_live_
Egnet forArbeidsflyter som berører din lokale maskin og maskinvareKontodata fra hvor som helst, uten installasjon

Ofte stilte spørsmål

Fungerer opptak offline?

Ja. Opptak skjer helt lokalt. Du trenger tilkobling for den innledende innloggingen og paringen, og igjen når du laster opp, men ikke mens du tar opp episoder.

Hvilke armer oppdager skrivebordsklienten?

SO-100 (SO-ARM100) er hovedarmen og fungerer rett ut av boksen. Se robot-siden for hele listen over støttede typer på plattformen.

Hvor får jeg en API-nøkkel?

Under /dashboard/settings. Nøkler starter med ayr_live_ og gir tilgang til kontoen din, så oppbevar dem som passord og tilbakekall enhver nøkkel du kan ha eksponert.

Kan jeg bruke den hostede MCP-serveren uten å installere noe?

Ja. Den snakker Streamable HTTP på https://www.ay-robots.com/api/mcp; alt du trenger er en MCP-klient og en API-nøkkel. Den lokale serveren er bare nødvendig når arbeidsflyten involverer din lokale maskin.