Desktop client at CLI

Ang desktop client ay para sa pag-record ng dataset gamit ang arm na nasa sarili mong desk: tinutukoy nito ang hardware, ginagabayan ka sa malinis na episode capture, at pinapanatiling lokal ang lahat hanggang sa magpasya kang mag-upload. Kasama ang CLI at doble ang gamit nito bilang MCP server.

Huling na-update 2026-08-09

Ano ang ginagawa ng desktop app

Ang browser cockpit ay ginawa para sa remote control ng robot na nasa platform. Sinasakop ng desktop client ang kabilang kalahati ng workflow: ikaw, isang robot arm sa iyong desk, at isang dataset na gusto mong i-record mismo. Kumokonekta ito sa arm sa pamamagitan ng USB, tinutukoy ang mga nakakonektang camera, at ginagabayan ka sa pag-record nang episode-by-episode.

Automatic ang detection. I-plug ang SO-100 at mahahanap ng app ang serial port at ie-enumerate ang mga servo; lilitaw ang mga nakakonektang webcam sa isang preview para masuri mo ang framing bago ka mag-record ng anuman. Walang configuration file na susulatin at walang driver na hahanapin.

Lahat ng ire-record mo ay isinusulat muna sa lokal na disk. Walang aalis sa makina mo hangga't hindi mo direktang ina-upload, mahalaga ito kung ang episode mo ay may bagay na hindi mo pa handang ibahagi, o kung nagre-record ka sa lugar na walang maaasahang koneksyon.

I-download at i-install

Available ang app para sa macOS, Windows, at Linux sa /download. I-install ito, mag-sign in gamit ang platform account mo, at ikonekta ang arm. Kung nagpe-pair ka rin ng robot sa platform sa parehong pagkakataon, dito mo rin ire-redeem ang pairing code mula sa wizard.

Ang guided recording flow

Ang pag-record ng magandang imitation learning data ay disiplina sa kadalasan, at ipinatutupad ito ng app para sa iyo. Dumadaan ang bawat episode sa parehong limang estasyon.

  1. 1
    Ilarawan ang gawain

    Isang malinaw na pangungusap, na paulit-ulit na sinasabi sa parehong paraan para sa parehong gawain. Binibigyang pansin ng language-conditioned policy ang string na ito, kaya mas maganda ang "pick up the red cube and place it in the bowl" kaysa sa "test 4".

  2. 2
    I-reset ang eksena

    Ilipat ang arm sa start pose nito at ilagay ang mga bagay. Nandiyan ang camera preview para makumpirma mo ang framing bago mag-commit, hindi pagkatapos.

  3. 3
    Mag-record

    I-teleoperate ang arm sa buong gawain nang may sinasadya at maayos na galaw. Huminto sa sandaling natapos na ang gawain sa halip na mag-idle sa frame.

  4. 4
    I-review

    I-playback ang episode bago ito panatilihin. Ilang segundo lang ang gastos sa pag-discard ng masamang episode; oras ang gastos sa pagta-train dito.

  5. 5
    I-upload

    Kapag kontento ka na, i-upload ang batch. Lilitaw ang mga episode sa dataset browser mo sa platform, kasabay ng anumang na-record sa pamamagitan ng remote session.

Lokal na data at LeRobot export

Naka-store at na-export ang mga episode sa LeRobot format, ang interchange format na tinatanggap ng karamihan sa open-source robot learning ecosystem. Ang dataset na na-record gamit ang desktop client ay puwedeng dumiretso sa training para sa ACT, Diffusion Policy, SmolVLA, o GR00T fine-tune.

Kailangan ng GR00T ang LeRobot v2.1

Kung plano mong mag-fine-tune ng GR00T, i-export ang dataset mo bilang LeRobot v2.1. Hindi tinatanggap ng GR00T ang ibang bersyon ng dataset, at hindi masaya ang malaman ito matapos ang mahabang session ng pag-record.

Ang CLI

Nag-i-install ang CLI nang standalone, kahit walang desktop app, kaya't ito ang tamang pagpipilian para sa headless machine at script. Sa macOS at Linux:

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

Sa Windows, sa PowerShell:

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

Nag-a-authenticate ang CLI gamit ang API key. Gumawa ng isa sa ilalim ng /dashboard/settings; may ayr_live_ prefix ang mga key at dapat itratong parang password, kaya panatilihin ang mga ito sa shell environment mo o sa secret manager sa halip na sa script na kina-commit mo.

MCP: lokal at hosted

Kung nagtatrabaho ka gamit ang MCP-capable na assistant o editor, maaabot ang platform sa pamamagitan ng Model Context Protocol sa dalawang paraan. Tumatakbo ang lokal na server sa makina mo at sisimulan ng isang command lang:

sh
ay-robots mcp
Simulan ang lokal na MCP server

Nasa https://www.ay-robots.com/api/mcp ang hosted server at nagsasalita ito ng Streamable HTTP. Walang kailangang i-install nang lokal: ituro lang ang MCP client mo sa URL at mag-authenticate gamit ang ayr_live_ API key mula sa /dashboard/settings para makagawa sa data ng account mo.

Lokal na MCP serverHosted MCP server
Paano patakbuhinay-robots mcp matapos i-install ang CLIWalang patatakbuhin, kumonekta sa https://www.ay-robots.com/api/mcp
TransportLokal na proseso, inilulunsad ng MCP client moStreamable HTTP
AuthAng mga CLI credential moAPI key na may ayr_live_ prefix
Mainam para saWorkflow na gumagalaw sa lokal na makina at hardware moData ng account mula saanman, walang instalasyon

Mga madalas itanong

Gumagana ba ang pag-record offline?

Oo. Buong lokal ang pag-record. Kailangan mo ng koneksyon para sa unang sign-in at pairing, at muli kapag nag-upload ka, pero hindi habang kumukuha ka ng episode.

Anong mga arm ang natutukoy ng desktop client?

Ang SO-100 (SO-ARM100) ang pangunahing arm at gumagana agad-agad. Tingnan ang robots page para sa buong listahan ng suportadong uri sa platform.

Saan ako kukuha ng API key?

Sa ilalim ng /dashboard/settings. Nagsisimula ang mga key sa ayr_live_ at nagbibigay ng access sa account mo, kaya itago ang mga ito parang password at bawiin ang anumang key na naipakita mo nang di-sinasadya.

Puwede ko bang gamitin ang hosted MCP server nang walang i-install?

Oo. Nagsasalita ito ng Streamable HTTP sa https://www.ay-robots.com/api/mcp; ang kailangan mo lang ay MCP client at API key. Kailangan lang ang lokal na server kapag kasama ang lokal na makina mo sa workflow.