Desktopklient och CLI

Vad desktopappen gör

Cockpiten i webbläsaren är byggd för fjärrstyrning av robotar som lever på plattformen. Desktopklienten täcker den andra halvan av arbetsflödet: du, en robotarm på ditt skrivbord och ett dataset du vill spela in själv. Den ansluter till armen via USB, känner av anslutna kameror och guidar dig genom inspelning episod för episod.

Detekteringen är automatisk. Koppla in en SO-100 så hittar appen serieporten och räknar upp servona; anslutna webbkameror visas i en förhandsgranskning så du kan kontrollera ramningen innan du spelar in något. Det finns ingen konfigurationsfil att skriva och ingen drivrutin att leta upp.

Allt du spelar in skrivs först till den lokala hårddisken. Inget lämnar din maskin förrän du uttryckligen laddar upp, vilket spelar roll om dina episoder innehåller sådant du inte är redo att dela, eller om du spelar in någonstans utan tillförlitlig uppkoppling.

Ladda ner och installera

Appen finns för macOS, Windows och Linux på /download. Installera den, logga in med ditt plattformskonto och anslut armen. Om du samtidigt parkopplar en robot till plattformen är appen också där du löser in parkopplingskoden från guiden.

Det guidade inspelningsflödet

Att spela in bra data för imitationsinlärning handlar mest om disciplin, och appen upprätthåller disciplinen åt dig. Varje episod går igenom samma fem stationer.

1. 1
   Beskriv uppgiften

   En tydlig mening, formulerad på samma sätt varje gång för samma uppgift. Språkvillkorade policyer uppmärksammar den här strängen, så "pick up the red cube and place it in the bowl" slår "test 4".

2. 2
   Återställ scenen

   Flytta armen till dess startposition och placera objekten. Kameraförhandsgranskningen finns där så att du kan bekräfta ramningen innan du bestämmer dig, inte efteråt.

3. 3
   Spela in

   Teleoperera armen genom uppgiften med medvetna, mjuka rörelser. Stanna så snart uppgiften är klar i stället för att stå still i bild.

4. 4
   Granska

   Spela upp episoden innan du behåller den. Att kassera en dålig episod tar sekunder; att träna på den kostar timmar.

5. 5
   Ladda upp

   När du är nöjd laddar du upp gruppen. Episoderna dyker upp i din datasetbläddrare på plattformen, tillsammans med allt som spelats in via fjärrsessioner.

Lokal data och LeRobot-export

Episoder lagras och exporteras i LeRobot-format, det utbytesformat som större delen av det öppna ekosystemet för robotinlärning accepterar. Ett dataset som spelats in med desktopklienten kan gå direkt till träning för ACT, Diffusion Policy, SmolVLA eller GR00T-finjusteringar.

CLI:t

CLI:t installeras fristående, utan desktopappen, vilket gör det till rätt val för headless-maskiner och skript. På macOS och 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:t autentiserar med en API-nyckel. Skapa en under /dashboard/settings; nycklar har prefixet ayr_live_ och bör behandlas som lösenord, så förvara dem i din skalmiljö eller en hemlighetshanterare i stället för i skript du checkar in.

MCP: lokalt och hostat

Arbetar du med en MCP-kapabel assistent eller editor är plattformen nåbar via Model Context Protocol på två sätt. Den lokala servern körs på din maskin och startas med ett enda kommando:

ay-robots mcp

Den hostade servern finns på https://www.ay-robots.com/api/mcp och pratar Streamable HTTP. Den kräver ingen lokal installation: peka din MCP-klient mot URL:en och autentisera med en ayr_live_-API-nyckel från /dashboard/settings för att arbeta med din kontodata.

Vanliga frågor