Client desktop și CLI

Ce face aplicația desktop

Cockpitul din browser este construit pentru controlul la distanță al roboților care există pe platformă. Clientul desktop acoperă cealaltă jumătate a fluxului de lucru: dumneavoastră, un braț robotic pe biroul propriu și un set de date pe care vreți să îl înregistrați singur. Se conectează la braț prin USB, detectează camerele conectate și vă ghidează prin înregistrare episod cu episod.

Detectarea este automată. Conectați un SO-100, iar aplicația găsește portul serial și enumeră servomotoarele; camerele web conectate apar într-o previzualizare, astfel încât puteți verifica încadrarea înainte de a înregistra ceva. Nu există niciun fișier de configurare de scris și niciun driver de căutat.

Tot ce înregistrați este scris mai întâi pe disc local. Nimic nu părăsește calculatorul dumneavoastră până nu îl încărcați explicit, ceea ce contează dacă episoadele conțin lucruri pe care nu sunteți încă pregătit să le distribuiți, sau dacă înregistrați undeva fără o conexiune fiabilă.

Descărcare și instalare

Aplicația este disponibilă pentru macOS, Windows și Linux la /download. Instalați-o, autentificați-vă cu contul de pe platformă și conectați brațul. Dacă în același timp asociați un robot cu platforma, aplicația este și locul unde folosiți codul de asociere din asistent.

Fluxul ghidat de înregistrare

Înregistrarea unor date bune pentru imitation learning este în mare parte o chestiune de disciplină, iar aplicația impune această disciplină pentru dumneavoastră. Fiecare episod trece prin aceleași cinci etape.

1. 1
   Descrieți sarcina

   O propoziție clară, formulată la fel de fiecare dată pentru aceeași sarcină. Policy-urile condiționate lingvistic țin cont de acest text, deci "ridică cubul roșu și pune-l în bol" este mai bun decât "test 4".

2. 2
   Resetați scena

   Mutați brațul în poziția de start și așezați obiectele. Previzualizarea camerei este acolo pentru a confirma încadrarea înainte de a începe, nu după.

3. 3
   Înregistrați

   Teleoperați brațul pe parcursul sarcinii cu mișcări deliberate, line. Opriți-vă imediat ce sarcina este completă, în loc să rămâneți inactiv în cadru.

4. 4
   Revizuiți

   Redați episodul înainte de a-l păstra. Renunțarea la un episod slab costă câteva secunde; antrenarea pe el costă ore.

5. 5
   Încărcați

   Când sunteți mulțumit, încărcați lotul. Episoadele apar în browserul de seturi de date de pe platformă, alături de tot ce a fost înregistrat prin sesiuni la distanță.

Date locale și export LeRobot

Episoadele sunt stocate și exportate în format LeRobot, formatul de schimb pe care îl acceptă cea mai mare parte a ecosistemului open-source de robot learning. Un set de date înregistrat cu clientul desktop poate merge direct în antrenarea pentru ACT, Diffusion Policy, SmolVLA sau fine-tune-uri GR00T.

CLI-ul

CLI-ul se instalează independent, fără aplicația desktop, ceea ce îl face alegerea potrivită pentru mașini headless și scripturi. Pe macOS și Linux:

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

Pe Windows, în PowerShell:

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

CLI-ul se autentifică printr-o cheie API. Creați una în /dashboard/settings; cheile poartă prefixul ayr_live_ și ar trebui tratate ca parole, deci păstrați-le în variabilele de mediu ale shell-ului sau într-un manager de secrete, nu în scripturi pe care le comiteți.

MCP: local și găzduit

Dacă lucrați cu un asistent sau editor compatibil MCP, platforma este accesibilă prin Model Context Protocol în două moduri. Serverul local rulează pe calculatorul dumneavoastră și pornește cu o singură comandă:

ay-robots mcp

Serverul găzduit se află la https://www.ay-robots.com/api/mcp și vorbește Streamable HTTP. Nu necesită nicio instalare locală: îndreptați clientul MCP către acest URL și autentificați-vă cu o cheie API ayr_live_ din /dashboard/settings pentru a lucra cu datele contului dumneavoastră.

Întrebări frecvente