Desktop klijent i CLI

Desktop klijent služi za snimanje datasetova s rukom na vašem vlastitom stolu: prepoznaje hardver, vodi vas kroz čisto snimanje epizoda i sve drži lokalno dok se ne odlučite za prijenos. CLI dolazi uz njega i ujedno funkcionira kao MCP server.

Zadnje ažurirano 2026-08-09

Što radi desktop aplikacija

Kokpit u pregledniku izgrađen je za daljinsko upravljanje robotima koji žive na platformi. Desktop klijent pokriva drugu polovicu procesa: vas, robotsku ruku na vašem stolu i dataset koji želite sami snimiti. Spaja se na ruku 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 te popisuje servomotore; spojene web kamere prikazuju se u pregledu kako biste mogli provjeriti kadar prije nego što išta snimite. Nema konfiguracijske datoteke koju treba pisati niti upravljačkog programa koji treba tražiti.

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

Preuzimanje i instalacija

Aplikacija je dostupna za macOS, Windows i Linux na /download. Instalirajte je, prijavite se svojim računom na platformi i spojite ruku. Ako istovremeno uparujete robota s platformom, u ovoj aplikaciji također unosite kod za uparivanje iz čarobnjaka.

Vođeni proces snimanja

Snimanje dobrih podataka za imitation learning uglavnom je pitanje discipline, a aplikacija tu disciplinu provodi umjesto vas. Svaka epizoda prolazi kroz istih pet postaja.

  1. 1
    Opišite zadatak

    Jedna jasna rečenica, formulirana na isti način svaki put za isti zadatak. Policyji uvjetovani jezikom obraćaju pozornost na taj string, pa "podigni crvenu kocku i stavi je u zdjelu" pobjeđuje nad "test 4".

  2. 2
    Resetirajte scenu

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

  3. 3
    Snimajte

    Teleoperirajte rukom kroz zadatak namjernim, glatkim pokretima. Zaustavite se čim je zadatak dovršen, umjesto da besposleno stojite u kadru.

  4. 4
    Pregledajte

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

  5. 5
    Prenesite

    Kad ste zadovoljni, prenesite paket. Epizode se pojavljuju u vašem pregledniku datasetova na platformi, uz sve što je snimljeno kroz udaljene sesije.

Lokalni podaci i izvoz u LeRobot

Epizode se pohranjuju i izvoze u LeRobot formatu, formatu razmjene koji prihvaća većina open-source ekosustava za robot learning. Dataset snimljen desktop klijentom može ići izravno u treniranje za ACT, Diffusion Policy, SmolVLA ili GR00T fine-tuneove.

GR00T treba LeRobot v2.1

Ako planirate fine-tuning GR00T-a, izvezite svoj dataset kao LeRobot v2.1. GR00T ne prihvaća druge verzije dataseta, a otkriti to nakon duge sesije snimanja nije nimalo zabavno.

CLI

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

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

Na Windowsu, u PowerShellu:

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

CLI se autentificira API ključem. Izradite ga pod /dashboard/settings; ključevi nose prefiks ayr_live_ i treba ih tretirati kao lozinke, pa ih čuvajte u varijablama okruženja ljuske ili upravitelju tajni, a ne u skriptama koje commitate.

MCP: lokalni i hostirani

Ako radite s asistentom ili editorom koji podržava MCP, platforma je dostupna preko Model Context Protocola na dva načina. Lokalni server radi na vašem računalu i pokreće se jednom naredbom:

sh
ay-robots mcp
Pokretanje lokalnog MCP servera

Hostirani server nalazi se na https://www.ay-robots.com/api/mcp i govori Streamable HTTP. Ne treba lokalnu instalaciju: usmjerite svog MCP klijenta na taj URL i autentificirajte se API ključem ayr_live_ s /dashboard/settings kako biste radili s podacima svog računa.

Lokalni MCP serverHostirani MCP server
Kako pokrenutiay-robots mcp nakon instalacije CLI-jaNišta se ne pokreće, spojite se na https://www.ay-robots.com/api/mcp
TransportLokalni proces, pokreće ga vaš MCP klijentStreamable HTTP
AutentifikacijaVaše CLI vjerodajniceAPI ključ s prefiksom ayr_live_
Dobar zaProcese koji dotiču vaše lokalno računalo i hardverPodatke računa odasvud, bez instalacije

Često postavljana pitanja

Radi li snimanje offline?

Da. Snimanje je u potpunosti lokalno. Veza vam treba za početnu prijavu i uparivanje, te ponovno pri prijenosu podataka, ali ne tijekom snimanja epizoda.

Koje ruke prepoznaje desktop klijent?

SO-100 (SO-ARM100) glavna je ruka i radi odmah po spajanju. Pogledajte stranicu o robotima za potpuni popis podržanih tipova na platformi.

Gdje mogu dobiti API ključ?

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

Mogu li koristiti hostirani MCP server bez ičega instaliranog?

Da. Govori Streamable HTTP na https://www.ay-robots.com/api/mcp; sve što trebate jest MCP klijent i API ključ. Lokalni server potreban je samo kad proces uključuje vaše lokalno računalo.