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.
- 1Opiš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".
- 2Resetirajte scenu
Vratite ruku u početni položaj i postavite predmete. Pregled kamere postoji da biste potvrdili kadar prije potvrde snimanja, a ne poslije.
- 3Snimajte
Teleoperirajte rukom kroz zadatak namjernim, glatkim pokretima. Zaustavite se čim je zadatak dovršen, umjesto da besposleno stojite u kadru.
- 4Pregledajte
Prije nego što zadržite epizodu, pustite je unatrag. Odbacivanje loše epizode košta sekunde; treniranje na njoj košta sate.
- 5Prenesite
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.
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:
curl -fsSL https://www.ay-robots.com/install.sh | shNa Windowsu, u PowerShellu:
irm https://www.ay-robots.com/install.ps1 | iexCLI 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:
ay-robots mcpHostirani 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 server | Hostirani MCP server | |
|---|---|---|
| Kako pokrenuti | ay-robots mcp nakon instalacije CLI-ja | Ništa se ne pokreće, spojite se na https://www.ay-robots.com/api/mcp |
| Transport | Lokalni proces, pokreće ga vaš MCP klijent | Streamable HTTP |
| Autentifikacija | Vaše CLI vjerodajnice | API ključ s prefiksom ayr_live_ |
| Dobar za | Procese koji dotiču vaše lokalno računalo i hardver | Podatke 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.
Kako AY-Robots pohranjuje snimke teleoperacije u LeRobot formatu: struktura epizoda, preglednik epizoda u nadzornoj ploči, spajanje prijenosa i tržište.
Otvorite račun na AY-Robots, odaberite ulogu klijenta ili operatera, postavite prvo okruženje, uparite robota kodom za uparivanje i pokrenite prvu sesiju.