Aplikasi desktop dan CLI

Aplikasi desktop untuk merakam set data dengan lengan di meja anda sendiri: ia mengesan perkakasan, membimbing anda melalui penangkapan episod yang bersih, dan mengekalkan segalanya secara tempatan sehingga anda memutuskan untuk memuat naik. CLI disertakan bersama dan turut berfungsi sebagai pelayan MCP.

Terakhir dikemas kini 2026-08-09

Fungsi aplikasi desktop

Cockpit pelayar dibina untuk kawalan jauh robot yang berada pada platform. Aplikasi desktop merangkumi separuh lagi aliran kerja: anda, lengan robot di meja anda, dan set data yang anda mahu rakam sendiri. Ia menyambung kepada lengan melalui USB, mengesan kamera yang disambungkan, dan membimbing anda merakam episod demi episod.

Pengesanan berlaku secara automatik. Sambungkan SO-100 dan aplikasi menemui port bersiri serta mengira servo; webcam yang disambungkan dipaparkan dalam pratonton supaya anda boleh menyemak pembingkaian sebelum merakam apa-apa. Tiada fail konfigurasi untuk ditulis dan tiada driver untuk dicari.

Segala yang anda rakam ditulis ke cakera tempatan terlebih dahulu. Tiada apa meninggalkan komputer anda sehingga anda memuat naik secara eksplisit, yang penting jika episod anda mengandungi perkara yang belum bersedia untuk dikongsi, atau jika anda merakam di tempat tanpa sambungan yang boleh dipercayai.

Muat turun dan pasang

Aplikasi ini tersedia untuk macOS, Windows, dan Linux di /download. Pasangnya, log masuk dengan akaun platform anda, dan sambungkan lengan. Jika anda memasangkan robot dengan platform pada masa yang sama, di sinilah juga anda menebus kod pemasangan daripada wizard.

Aliran rakaman berpandu

Merakam data imitation learning yang baik kebanyakannya soal disiplin, dan aplikasi ini menguatkuasakan disiplin itu untuk anda. Setiap episod melalui lima perhentian yang sama.

  1. 1
    Terangkan tugas

    Satu ayat yang jelas, disebut dengan cara yang sama setiap kali untuk tugas yang sama. Policy bersyarat bahasa memberi perhatian kepada rentetan ini, jadi "pick up the red cube and place it in the bowl" lebih baik daripada "test 4".

  2. 2
    Set semula adegan

    Gerakkan lengan ke kedudukan permulaannya dan letakkan objek. Pratonton kamera ada di situ supaya anda boleh mengesahkan pembingkaian sebelum meneruskan, bukan selepasnya.

  3. 3
    Rakam

    Teleoperasikan lengan melalui tugas dengan pergerakan yang disengajakan dan lancar. Berhenti sebaik sahaja tugas selesai dan bukannya berdiam dalam bingkai.

  4. 4
    Semak

    Mainkan semula episod sebelum menyimpannya. Membuang episod yang buruk mengambil masa beberapa saat; melatih dengannya mengambil masa berjam-jam.

  5. 5
    Muat naik

    Apabila berpuas hati, muat naik kelompok itu. Episod dipaparkan dalam pelayar set data anda pada platform, bersama apa jua yang dirakam melalui sesi jauh.

Data tempatan dan eksport LeRobot

Episod disimpan dan dieksport dalam format LeRobot, format pertukaran yang diterima oleh kebanyakan ekosistem sumber terbuka pembelajaran robot. Set data yang dirakam dengan aplikasi desktop boleh terus digunakan untuk latihan ACT, Diffusion Policy, SmolVLA, atau fine-tune GR00T.

GR00T memerlukan LeRobot v2.1

Jika anda merancang untuk melakukan fine-tune GR00T, eksport set data anda sebagai LeRobot v2.1. GR00T tidak menerima versi set data lain, dan mengetahui perkara ini selepas sesi rakaman yang panjang bukanlah menyeronokkan.

CLI

CLI dipasang secara berasingan, tanpa aplikasi desktop, menjadikannya pilihan yang tepat untuk mesin headless dan skrip. Pada macOS dan Linux:

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

Pada Windows, dalam PowerShell:

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

CLI disahkan dengan kunci API. Cipta satu di /dashboard/settings; kunci membawa awalan ayr_live_ dan harus dilayan seperti kata laluan, jadi simpannya dalam persekitaran shell anda atau pengurus rahsia dan bukannya dalam skrip yang anda commit.

MCP: tempatan dan dihoskan

Jika anda bekerja dengan pembantu atau editor yang menyokong MCP, platform boleh dicapai melalui Model Context Protocol dalam dua cara. Pelayan tempatan berjalan pada komputer anda dan dimulakan dengan satu arahan:

sh
ay-robots mcp
Mulakan pelayan MCP tempatan

Pelayan yang dihoskan berada di https://www.ay-robots.com/api/mcp dan bertutur Streamable HTTP. Ia tidak memerlukan pemasangan tempatan: arahkan klien MCP anda ke URL tersebut dan sahkan dengan kunci API berawalan ayr_live_ daripada /dashboard/settings untuk bekerja dengan data akaun anda.

Pelayan MCP tempatanPelayan MCP dihoskan
Cara menjalankanay-robots mcp selepas memasang CLITiada apa untuk dijalankan, sambung ke https://www.ay-robots.com/api/mcp
PengangkutanProses tempatan, dilancarkan oleh klien MCP andaStreamable HTTP
PengesahanKelayakan CLI andaKunci API dengan awalan ayr_live_
Sesuai untukAliran kerja yang melibatkan komputer dan perkakasan tempatan andaData akaun dari mana-mana sahaja, tanpa pemasangan

Soalan lazim

Adakah rakaman berfungsi luar talian?

Ya. Rakaman sepenuhnya tempatan. Anda memerlukan sambungan untuk log masuk awal dan pemasangan, dan sekali lagi apabila anda memuat naik, tetapi bukan semasa menangkap episod.

Lengan mana yang dikesan oleh aplikasi desktop?

SO-100 (SO-ARM100) ialah lengan utama dan berfungsi terus tanpa persediaan. Lihat halaman robot untuk senarai penuh jenis yang disokong pada platform.

Di mana saya boleh dapatkan kunci API?

Di /dashboard/settings. Kunci bermula dengan ayr_live_ dan memberikan akses kepada akaun anda, jadi simpannya seperti kata laluan dan batalkan mana-mana kunci yang mungkin terdedah.

Bolehkah saya gunakan pelayan MCP dihoskan tanpa memasang apa-apa?

Ya. Ia bertutur Streamable HTTP di https://www.ay-robots.com/api/mcp; anda hanya memerlukan klien MCP dan kunci API. Pelayan tempatan hanya diperlukan apabila aliran kerja melibatkan komputer tempatan anda.