Desktop klijent i CLI

Desktop klijent služi za snimanje dataset-ova sa rukom na vašem vlastitom stolu: prepoznaje hardver, vodi vas kroz čisto snimanje epizoda i sve čuva lokalno dok sami ne odlučite da otpremite. CLI dolazi zajedno sa njim i istovremeno služi kao MCP server.

Zadnje ažurirano 2026-08-09

Šta radi desktop aplikacija

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

Prepoznavanje je automatsko. Priključite SO-100 i aplikacija pronalazi serijski port i nabraja servomotore; povezane webkamere se pojavljuju u pregledu kako biste provjerili kadar prije nego što bilo šta snimite. Nema fajla za konfiguraciju koji treba pisati niti drajvera koji treba tražiti.

Sve što snimite prvo se zapisuje na lokalni disk. Ništa ne napušta vaš računar dok izričito ne otpremite, što je važno ako vaše epizode sadrže nešto što još niste spremni podijeliti, ili ako snimate negdje bez pouzdane veze.

Preuzimanje i instalacija

Aplikacija je dostupna za macOS, Windows i Linux na /download. Instalirajte je, prijavite se sa svojim računom na platformi i povežite ruku. Ako u isto vrijeme uparujete robota sa platformom, aplikacija je i mjesto gdje iskorištavate kod za uparivanje iz čarobnjaka.

Vođeni proces snimanja

Snimanje dobrih podataka za imitation learning je uglavnom disciplina, a aplikacija tu disciplinu nameće umjesto vas. Svaka epizoda prolazi kroz istih pet stanica.

  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 ovaj tekst, pa "uzmi crvenu kocku i stavi je u posudu" pobjeđuje nad "test 4".

  2. 2
    Resetujte scenu

    Pomjerite ruku u početnu pozu i rasporedite predmete. Pregled sa kamere je tu da potvrdite kadar prije nego što počnete, a ne poslije.

  3. 3
    Snimajte

    Teleoperirajte ruku kroz zadatak namjernim, glatkim pokretima. Zaustavite se čim je zadatak završen, umjesto da mirujete u kadru.

  4. 4
    Pregledajte

    Pustite epizodu prije nego što je zadržite. Odbacivanje loše epizode košta sekunde; treniranje na njoj košta sate.

  5. 5
    Otpremite

    Kada ste zadovoljni, otpremite seriju. Epizode se pojavljuju u pregledaču dataset-ova na platformi, uz sve što je snimljeno kroz sesije na daljinu.

Lokalni podaci i izvoz u LeRobot

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

GR00T zahtijeva LeRobot v2.1

Ako planirate fine-tune GR00T-a, izvezite svoj dataset kao LeRobot v2.1. GR00T ne prihvata druge verzije dataset-a, a otkrivanje toga nakon duge sesije snimanja nije nimalo zabavno.

CLI

CLI se instalira samostalno, bez desktop aplikacije, što ga čini pravim izborom za mašine bez grafičkog interfejsa i za skripte. Na macOS-u i Linuxu:

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

Na Windowsu, u PowerShell-u:

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

CLI se autentikuje API ključem. Kreirajte ga pod /dashboard/settings; ključevi nose prefiks ayr_live_ i trebaju se tretirati kao lozinke, pa ih čuvajte u okruženju svoje ljuske ili u 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
Pokrenite lokalni MCP server

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

Lokalni MCP serverHostovani MCP server
Kako se pokrećeay-robots mcp nakon instalacije CLI-jaNišta se ne pokreće, povežite se na https://www.ay-robots.com/api/mcp
TransportLokalni proces, pokrenut od strane vašeg MCP klijentaStreamable HTTP
AutentikacijaVaši CLI kredencijaliAPI ključ sa prefiksom ayr_live_
Pogodno zaRadne tokove koji se tiču vašeg lokalnog računara i hardveraPodatke sa računa odasvud, bez instalacije

Često postavljana pitanja

Da li snimanje radi offline?

Da. Snimanje je potpuno lokalno. Potrebna vam je veza za početnu prijavu i uparivanje, i ponovo kada otpremate, ali ne dok snimate epizode.

Koje ruke prepoznaje desktop klijent?

SO-100 (SO-ARM100) je glavna ruka i radi odmah po priključivanju. Pogledajte stranicu o robotima za punu listu podržanih tipova na platformi.

Gdje dobijem API ključ?

Pod /dashboard/settings. Ključevi počinju sa ayr_live_ i daju pristup vašem računu, pa ih čuvajte kao lozinke i opozovite svaki ključ koji ste možda izložili.

Mogu li koristiti 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 radni tok uključuje vaš lokalni računar.