Desktop klijent i CLI

Desktop klijent služi za snimanje dataset-ova sa rukom na vašem sopstvenom stolu: prepoznaje hardver, vodi vas kroz čisto snimanje epizoda i sve drži lokalno dok se ne odlučite za prenos. CLI dolazi uz njega i ujedno funkcioniše kao MCP server.

Poslednje ažurirano 2026-08-09

Šta radi desktop aplikacija

Kokpit u pregledaču napravljen je za daljinsko upravljanje robotima koji žive na platformi. Desktop klijent pokriva drugu polovinu procesa: vas, robotsku ruku na vašem stolu i dataset koji želite sami da snimite. Povezuje se sa rukom preko USB-a, prepoznaje priključene kamere i vodi vas kroz snimanje epizoda po epizodu.

Prepoznavanje je automatsko. Priključite SO-100 i aplikacija pronalazi serijski port i popisuje servo motore; povezane veb kamere se prikazuju u pregledu kako biste mogli da proverite kadar pre nego što bilo šta snimite. Nema konfiguracione datoteke koju treba pisati niti drajvera koji treba tražiti.

Sve što snimite prvo se upisuje na lokalni disk. Ništa ne napušta vaš računar dok izričito ne prenesete podatke, što je važno ako vaše epizode sadrže nešto što još niste spremni da podelite, ili ako snimate na mestu bez pouzdane veze.

Preuzimanje i instalacija

Aplikacija je dostupna za macOS, Windows i Linux na /download. Instalirajte je, prijavite se svojim nalogom na platformi i povežite ruku. Ako istovremeno uparujete robota sa platformom, u ovoj aplikaciji takođe unosite kod za uparivanje iz čarobnjaka.

Vođen proces snimanja

Snimanje dobrih podataka za imitation learning je uglavnom pitanje discipline, a aplikacija tu disciplinu sprovodi umesto vas. Svaka epizoda prolazi kroz istih pet faza.

  1. 1
    Opišite zadatak

    Jedna jasna rečenica, formulisana na isti način svaki put za isti zadatak. Policy uslovljeni jezikom obraćaju pažnju na taj string, pa "podigni crvenu kocku i stavi je u posudu" pobeđuje "test 4".

  2. 2
    Resetujte scenu

    Vratite ruku u početni položaj i postavite predmete. Pregled kamere postoji da biste potvrdili kadar pre potvrde snimanja, a ne posle.

  3. 3
    Snimajte

    Teleoperišite rukom kroz zadatak namernim, glatkim pokretima. Zaustavite se čim je zadatak završen, umesto da besposleno stojite u kadru.

  4. 4
    Pregledajte

    Pre nego što zadržite epizodu, pustite je unazad. Odbacivanje loše epizode košta sekunde; treniranje na njoj košta sate.

  5. 5
    Prenesite

    Kada ste zadovoljni, prenesite paket. Epizode se pojavljuju u vašem pregledaču dataset-ova na platformi, pored svega što je snimljeno kroz udaljene sesije.

Lokalni podaci i izvoz u LeRobot

Epizode se čuvaju i izvoze u LeRobot formatu, formatu razmene koji prihvata većina open-source ekosistema za robot learning. Dataset snimljen desktop klijentom može da ide direktno u treniranje za ACT, Diffusion Policy, SmolVLA ili GR00T fine-tune-ove.

GR00T-u je potreban LeRobot v2.1

Ako planirate fine-tuning GR00T-a, izvezite svoj dataset kao LeRobot v2.1. GR00T ne prihvata druge verzije dataset-a, a otkriti to nakon duge sesije snimanja nikako nije prijatno.

CLI

CLI se instalira samostalno, bez desktop aplikacije, što ga čini pravim izborom za bezglave računare i skripte. Na macOS-u i Linux-u:

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

Na Windows-u, u PowerShell-u:

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

CLI se autentifikuje API ključem. Kreirajte ga pod /dashboard/settings; ključevi nose prefiks ayr_live_ i treba ih tretirati kao lozinke, pa ih čuvajte u promenljivama okruženja šela ili menadžeru tajni, a ne u skriptama koje komitujete.

MCP: lokalni i hostovani

Ako radite sa asistentom ili editorom koji podržava MCP, platforma je dostupna preko Model Context Protocol-a na dva načina. Lokalni server radi na vašem računaru i pokreće se jednom komandom:

sh
ay-robots mcp
Pokretanje lokalnog MCP servera

Hostovani server se nalazi na https://www.ay-robots.com/api/mcp i govori Streamable HTTP. Ne zahteva lokalnu instalaciju: usmerite svog MCP klijenta na taj URL i autentifikujte se API ključem ayr_live_ sa /dashboard/settings da biste radili sa podacima svog naloga.

Lokalni MCP serverHostovani MCP server
Kako pokrenutiay-robots mcp nakon instalacije CLI-jaNišta se ne pokreće, povežite se na https://www.ay-robots.com/api/mcp
TransportLokalni proces, pokreće ga vaš MCP klijentStreamable HTTP
AutentifikacijaVaše CLI kredencijaleAPI ključ sa prefiksom ayr_live_
Dobar zaProcese koji dodiruju vaš lokalni računar i hardverPodatke naloga odasvud, bez instalacije

Često postavljana pitanja

Da li snimanje radi oflajn?

Da. Snimanje je u potpunosti lokalno. Veza vam je potrebna za početnu prijavu i uparivanje, i ponovo prilikom prenosa podataka, ali ne tokom snimanja epizoda.

Koje ruke prepoznaje desktop klijent?

SO-100 (SO-ARM100) je glavna ruka i radi odmah nakon povezivanja. Pogledajte stranicu o robotima za potpunu listu podržanih tipova na platformi.

Gde mogu da dobijem API ključ?

Pod /dashboard/settings. Ključevi počinju sa ayr_live_ i daju pristup vašem nalogu, pa ih čuvajte kao lozinke i opozovite svaki ključ koji je možda otkriven.

Mogu li da koristim hostovani MCP server bez instaliranja bilo čega?

Da. Govori Streamable HTTP na https://www.ay-robots.com/api/mcp; sve što vam treba je MCP klijent i API ključ. Lokalni server je potreban samo kada proces uključuje vaš lokalni računar.