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.
- 1Ilarawan 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".
- 2I-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.
- 3Mag-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.
- 4I-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.
- 5I-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.
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:
curl -fsSL https://www.ay-robots.com/install.sh | shSa Windows, sa PowerShell:
irm https://www.ay-robots.com/install.ps1 | iexNag-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:
ay-robots mcpNasa 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 server | Hosted MCP server | |
|---|---|---|
| Paano patakbuhin | ay-robots mcp matapos i-install ang CLI | Walang patatakbuhin, kumonekta sa https://www.ay-robots.com/api/mcp |
| Transport | Lokal na proseso, inilulunsad ng MCP client mo | Streamable HTTP |
| Auth | Ang mga CLI credential mo | API key na may ayr_live_ prefix |
| Mainam para sa | Workflow na gumagalaw sa lokal na makina at hardware mo | Data 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.
Paano nag-i-store ang AY-Robots ng teleoperation recording sa LeRobot format: episode structure, ang dashboard episode browser, pagsasama-sama ng upload, at ang marketplace.
Gumawa ng AY-Robots account, piliin ang role na client o operator, mag-set up ng unang environment, i-pair ang isang robot gamit ang pairing code, at magpatakbo ng unang session.