Darbvirsmas klients un CLI

Darbvirsmas klients ir paredzēts datu kopu ierakstīšanai ar roku uz jūsu paša galda: tas atklāj aparatūru, izvada jūs cauri tīrai epizožu uzņemšanai un visu patur lokāli, kamēr izlemjat augšupielādēt. Tam līdzi nāk CLI, kas vienlaikus darbojas arī kā MCP serveris.

Pēdējoreiz atjaunināts 2026-08-09

Ko dara darbvirsmas lietotne

Pārlūka kabīne ir veidota attālinātai to robotu vadībai, kas dzīvo platformā. Darbvirsmas klients aptver otru darba plūsmas pusi: jūs, robota roku uz jūsu galda un datu kopu, ko vēlaties ierakstīt paši. Tas savienojas ar roku caur USB, atklāj pievienotās kameras un vada jūs cauri ierakstīšanai epizode pēc epizodes.

Noteikšana ir automātiska. Pievienojiet SO-100, un lietotne atrod seriālo portu un uzskaita servopiedziņas; pievienotās tīmekļa kameras parādās priekšskatījumā, lai varētu pārbaudīt kadrējumu pirms ierakstīšanas. Konfigurācijas fails nav jāraksta, un draiveris nav jāmeklē.

Viss, ko ierakstāt, vispirms tiek rakstīts lokālajā diskā. Nekas nepamet jūsu ierīci, kamēr skaidri neaugšupielādējat, kas ir svarīgi, ja jūsu epizodēs ir kaut kas, ar ko vēl neesat gatavi dalīties, vai ja ierakstāt vietā bez uzticama savienojuma.

Lejupielāde un instalēšana

Lietotne ir pieejama macOS, Windows un Linux sistēmām adresē /download. Instalējiet, pierakstieties ar savu platformas kontu un pievienojiet roku. Ja tajā pašā laikā sapārojat robotu ar platformu, šajā lietotnē arī izmantojat sapārošanas kodu no vedņa.

Vadītais ierakstīšanas process

Kvalitatīvu imitācijas mācīšanās datu ierakstīšana galvenokārt ir disciplīna, un lietotne šo disciplīnu nodrošina jūsu vietā. Katra epizode iziet cauri tiem pašiem pieciem posmiem.

  1. 1
    Aprakstiet uzdevumu

    Viens skaidrs teikums, katru reizi formulēts vienādi tam pašam uzdevumam. Valodā balstīti policy pievērš uzmanību šai rindai, tāpēc "pick up the red cube and place it in the bowl" ir labāks par "test 4".

  2. 2
    Atiestatiet ainu

    Pārvietojiet roku sākuma pozā un novietojiet objektus. Kameras priekšskatījums ir tur, lai apstiprinātu kadrējumu pirms ierakstīšanas, nevis pēc tam.

  3. 3
    Ierakstiet

    Teleoperējiet roku, izpildot uzdevumu ar apzinātām, gludām kustībām. Apstājieties, tiklīdz uzdevums pabeigts, nevis stāviet dīkā kadrā.

  4. 4
    Pārskatiet

    Atskaņojiet epizodi pirms tās saglabāšanas. Sliktas epizodes atmešana maksā sekundes; apmācība ar to maksā stundas.

  5. 5
    Augšupielādējiet

    Kad esat apmierināti, augšupielādējiet paketi. Epizodes parādās jūsu datu kopu pārlūkā platformā, kopā ar visu, kas ierakstīts attālinātajās sesijās.

Lokālie dati un LeRobot eksports

Epizodes tiek glabātas un eksportētas LeRobot formātā, apmaiņas formātā, ko pieņem lielākā daļa atvērtā koda robotu mācīšanās ekosistēmas. Ar darbvirsmas klientu ierakstīta datu kopa var doties tieši apmācībā ACT, Diffusion Policy, SmolVLA vai GR00T fine-tune.

GR00T vajadzīgs LeRobot v2.1

Ja plānojat veikt GR00T fine-tune, eksportējiet datu kopu kā LeRobot v2.1. GR00T nepieņem citas datu kopu versijas, un to uzzināt pēc garas ierakstīšanas sesijas nav patīkami.

CLI

CLI instalējas patstāvīgi, bez darbvirsmas lietotnes, kas padara to par pareizo izvēli bezekrāna ierīcēm un skriptiem. macOS un Linux sistēmās:

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

Windows sistēmā, PowerShell:

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

CLI autentificējas ar API atslēgu. Izveidojiet to /dashboard/settings; atslēgām ir priedēklis ayr_live_, un ar tām jāapietas kā ar parolēm, tāpēc glabājiet tās vides mainīgajos vai slepeno datu pārvaldniekā, nevis skriptos, kurus iesniedzat repozitorijā.

MCP: lokālais un hostētais

Ja strādājat ar MCP saderīgu asistentu vai redaktoru, platforma ir sasniedzama caur Model Context Protocol divos veidos. Lokālais serveris darbojas jūsu ierīcē un tiek palaists ar vienu komandu:

sh
ay-robots mcp
Palaidiet lokālo MCP serveri

Hostētais serveris atrodas adresē https://www.ay-robots.com/api/mcp un runā Streamable HTTP. Tam nav vajadzīga lokāla instalācija: norādiet savam MCP klientam šo URL un autentificējieties ar ayr_live_ API atslēgu no /dashboard/settings, lai strādātu ar sava konta datiem.

Lokālais MCP serverisHostētais MCP serveris
Kā palaistay-robots mcp pēc CLI instalēšanasNekas nav jāpalaiž, pieslēdzieties https://www.ay-robots.com/api/mcp
TransportsLokāls process, ko palaiž jūsu MCP klientsStreamable HTTP
AutentifikācijaJūsu CLI akreditācijas datiAPI atslēga ar ayr_live_ priedēkli
DerDarba plūsmām, kas skar jūsu lokālo ierīci un aparatūruKonta datiem no jebkuras vietas, bez instalēšanas

Biežāk uzdotie jautājumi

Vai ierakstīšana darbojas bezsaistē?

Jā. Ierakstīšana notiek pilnībā lokāli. Savienojums vajadzīgs sākotnējai pierakstīšanās un sapārošanas reizei, un vēlreiz, kad augšupielādējat, bet ne epizožu uzņemšanas laikā.

Kuras rokas atklāj darbvirsmas klients?

SO-100 (SO-ARM100) ir galvenā roka un darbojas uzreiz. Pilnu atbalstīto tipu sarakstu platformā skatiet robotu lapā.

Kur iegūt API atslēgu?

Adresē /dashboard/settings. Atslēgas sākas ar ayr_live_ un piešķir piekļuvi jūsu kontam, tāpēc glabājiet tās kā paroles un atsauciet jebkuru atslēgu, ko varētu būt atklājuši.

Vai varu izmantot hostēto MCP serveri, neko neinstalējot?

Jā. Tas runā Streamable HTTP adresē https://www.ay-robots.com/api/mcp; nepieciešams tikai MCP klients un API atslēga. Lokālais serveris ir nepieciešams tikai tad, kad darba plūsma skar jūsu lokālo ierīci.