Klienti desktop dhe CLI

Klienti desktop shërben për të regjistruar dataset-e me një krah në tavolinën tuaj: zbulon harduerin, ju udhëheq drejt kapjes së pastër të episodeve dhe i mban gjërat lokalisht derisa ju vendosni t'i ngarkoni. CLI-ja vjen bashkë me të dhe njëkohësisht shërben si server MCP.

Përditësuar së fundmi 2026-08-09

Çfarë bën aplikacioni desktop

Kokpiti në shfletues është ndërtuar për kontrollin në distancë të robotëve që jetojnë në platformë. Klienti desktop mbulon gjysmën tjetër të rrjedhës së punës: ju, një krah robotik në tavolinën tuaj dhe një dataset që doni ta regjistroni vetë. Lidhet me krahun përmes USB, zbulon kamerat e lidhura dhe ju udhëheq nëpër regjistrim, episod pas episodi.

Zbulimi është automatik. Lidhni një SO-100 dhe aplikacioni gjen portin serial dhe numëron servomotorët; webkamerat e lidhura shfaqen në një pamje paraprake që të mund të kontrolloni kadrimin para se të regjistroni diçka. Nuk ka skedar konfigurimi për t'u shkruar dhe nuk ka drajver për t'u kërkuar.

Gjithçka që regjistroni shkruhet fillimisht në diskun lokal. Asgjë nuk e lë kompjuterin tuaj derisa ta ngarkoni shprehimisht, gjë që ka rëndësi nëse episodet tuaja përmbajnë gjëra që ende nuk jeni gati t'i ndani, ose nëse po regjistroni diku pa lidhje të qëndrueshme.

Shkarkimi dhe instalimi

Aplikacioni është i disponueshëm për macOS, Windows dhe Linux te /download. Instalojeni, identifikohuni me llogarinë tuaj të platformës dhe lidhni krahun. Nëse po çift-lidhni një robot me platformën në të njëjtën kohë, aplikacioni është gjithashtu vendi ku përdorni kodin e çiftimit nga asistenti.

Procesi i udhëhequr i regjistrimit

Regjistrimi i të dhënave të mira për imitation learning është kryesisht disiplinë, dhe aplikacioni e imponon atë disiplinë për ju. Çdo episod kalon nëpër të njëjtat pesë stacione.

  1. 1
    Përshkruani detyrën

    Një fjali e qartë, e formuluar në të njëjtën mënyrë çdo herë për të njëjtën detyrë. Policy-të e kushtëzuara nga gjuha i kushtojnë vëmendje kësaj vargu, kështu që "merr kubin e kuq dhe vendose në kupë" mund ta zëvendësojë diçka të paqartë si "test 4".

  2. 2
    Rivendosni skenën

    Lëvizni krahun në pozicionin fillestar dhe vendosni objektet. Pamja paraprake e kamerës është aty që të konfirmoni kadrimin para se të filloni, jo pas.

  3. 3
    Regjistroni

    Teleoperoni krahun nëpër detyrë me lëvizje të qëllimshme dhe të buta. Ndaluni sapo detyra të përfundojë, në vend që të qëndroni në kuadër pa bërë asgjë.

  4. 4
    Shqyrtoni

    Riluani episodin para se ta mbani. Hedhja e një episodi të keq kushton sekonda; trajnimi mbi të kushton orë.

  5. 5
    Ngarkoni

    Kur jeni të kënaqur, ngarkoni grupin. Episodet shfaqen në shfletuesin e dataset-eve të platformës, krahas gjithçkaje të regjistruar përmes sesioneve në distancë.

Të dhënat lokale dhe eksporti LeRobot

Episodet ruhen dhe eksportohen në formatin LeRobot, formati i shkëmbimit që pranon pjesa më e madhe e ekosistemit me burim të hapur për robot learning. Një dataset i regjistruar me klientin desktop mund të kalojë direkt në trajnim për ACT, Diffusion Policy, SmolVLA ose GR00T fine-tune.

GR00T kërkon LeRobot v2.1

Nëse planifikoni fine-tune të GR00T, eksportoni dataset-in tuaj si LeRobot v2.1. GR00T nuk pranon versione të tjera dataset-i, dhe ta zbuloni këtë pas një sesioni të gjatë regjistrimi nuk është aspak argëtuese.

CLI-ja

CLI-ja instalohet e pavarur, pa aplikacionin desktop, gjë që e bën zgjedhjen e duhur për makina pa ndërfaqe grafike dhe për skripte. Në macOS dhe Linux:

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

Në Windows, në PowerShell:

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

CLI-ja autentikohet me një çelës API. Krijoni njërin te /dashboard/settings; çelësat mbajnë prefiksin ayr_live_ dhe duhen trajtuar si fjalëkalime, kështu që mbajini në mjedisin e shell-it tuaj ose në një menaxher sekretesh, jo në skripte që i komitoni.

MCP: lokal dhe i hostuar

Nëse punoni me një asistent ose editor që mbështet MCP, platforma është e arritshme përmes Model Context Protocol në dy mënyra. Serveri lokal punon në kompjuterin tuaj dhe niset me një komandë të vetme:

sh
ay-robots mcp
Nisni serverin lokal MCP

Serveri i hostuar ndodhet te https://www.ay-robots.com/api/mcp dhe flet Streamable HTTP. Nuk kërkon instalim lokal: drejtojeni klientin tuaj MCP te URL-ja dhe autentikohuni me një çelës API me prefiksin ayr_live_ nga /dashboard/settings për të punuar me të dhënat e llogarisë suaj.

Serveri lokal MCPServeri i hostuar MCP
Si nisetay-robots mcp pas instalimit të CLI-sëAsgjë për t'u nisur, lidhuni te https://www.ay-robots.com/api/mcp
TransportiProces lokal, i nisur nga klienti juaj MCPStreamable HTTP
AutentikimiKredencialet tuaja të CLI-sëÇelës API me prefiksin ayr_live_
I përshtatshëm përRrjedha pune që përfshijnë kompjuterin dhe harduerin tuaj lokalTë dhënat e llogarisë nga kudo, pa instalim

Pyetje të shpeshta

A funksionon regjistrimi offline?

Po. Regjistrimi është plotësisht lokal. Ju duhet lidhje interneti për identifikimin fillestar dhe çiftimin, dhe përsëri kur ngarkoni, por jo gjatë kapjes së episodeve.

Cilët krahë i zbulon klienti desktop?

SO-100 (SO-ARM100) është krahu kryesor dhe funksionon menjëherë. Shikoni faqen e robotëve për listën e plotë të tipeve të mbështetura në platformë.

Ku e marr një çelës API?

Te /dashboard/settings. Çelësat fillojnë me ayr_live_ dhe japin qasje në llogarinë tuaj, kështu që ruajini si fjalëkalime dhe revokoni çdo çelës që mund ta keni ekspozuar.

A mund ta përdor serverin e hostuar MCP pa instaluar asgjë?

Po. Flet Streamable HTTP te https://www.ay-robots.com/api/mcp; ju duhet vetëm një klient MCP dhe një çelës API. Serveri lokal nevojitet vetëm kur rrjedha e punës përfshin kompjuterin tuaj lokal.