Десктоп клиент және CLI

Десктоп клиенті өз үстеліңіздегі қолмен датасет жазу үшін арналған: ол жабдықты анықтайды, таза эпизод түсіруге бағыттайды және сіз жүктеп салуға шешім қабылдағанша барлық нәрсені жергілікті сақтайды. CLI онымен бірге келеді және MCP сервері ретінде де қызмет етеді.

Соңғы жаңарту 2026-08-09

Десктоп қосымшасы не істейді

Браузер кокпиті платформадағы роботтарды қашықтан басқаруға арналған. Десктоп клиенті жұмыс ағынының басқа жартысын қамтиды: сіз, үстеліңіздегі робот қолы және өзіңіз жазғыңыз келетін датасет. Ол USB арқылы қолмен байланысады, қосылған камераларды анықтайды және эпизод бойынша эпизод жазуға бағыттайды.

Анықтау автоматты түрде жүреді. SO-100 қосыңыз, қосымша тізбекті портты тауып, сервоприводтарды санайды; байланысқан веб-камералар алдын ала қарауда пайда болады, сондықтан жазбас бұрын кадрлеуді тексере аласыз. Жазатын баптау файлы жоқ, іздеп табуды қажет ететін драйвер жоқ.

Жазғаныңыздың бәрі алдымен жергілікті дискіге жазылады. Сіз нақты түрде жүктеп салмайынша ешнәрсе компьютеріңізден кетпейді, бұл эпизодтарыңызда әлі бөліскіңіз келмейтін нәрселер болса немесе сенімді байланысы жоқ жерде жазып жатсаңыз маңызды.

Жүктеп алу және орнату

Қосымша macOS, Windows және Linux үшін /download бетінде қолжетімді. Орнатыңыз, платформа есептік жазбаңызбен кіріңіз, қолды қосыңыз. Сонымен бір мезгілде роботты платформамен жұптап жатсаңыз, шебердің жұптау кодын енгізетін жері де осы қосымша.

Бағыттаушы жазу ағыны

Жақсы имитациялық оқыту деректерін жазу негізінен тәртіпке байланысты, ал қосымша сол тәртіпті сіздің орныңызға орындайды. Әр эпизод бірдей бес кезеңнен өтеді.

  1. 1
    Тапсырманы сипаттау

    Бір нақты сөйлем, бірдей тапсырма үшін әрдайым бірдей түрде айтылған. Тілге бейімделген полисилер осы жолға назар аударады, сондықтан "қызыл текшені алып, оны тостаған ішіне қой" деген сөйлем "тест 4"-тен жақсырақ нәтиже береді.

  2. 2
    Сахнаны қалпына келтіру

    Қолды бастапқы позицияға жылжытып, заттарды орналастырыңыз. Камера алдын ала қарауы жазуды бастамас бұрын кадрлеуді растау үшін, кейін емес, сол жерде тұрады.

  3. 3
    Жазу

    Қолды тапсырма бойынша нақты, тегіс қозғалыстармен қашықтан басқарыңыз. Тапсырма аяқталған бойда тоқтаңыз, кадрда бос тұрмаңыз.

  4. 4
    Қарау

    Сақтаудың алдында эпизодты қайта ойнатыңыз. Нашар эпизодты тастау бірнеше секунд алады; оны оқытуға пайдалану сағаттар алады.

  5. 5
    Жүктеп салу

    Қанағаттанғаннан кейін топтаманы жүктеп салыңыз. Эпизодтар қашықтан сессиялардан жазылған кез келген нәрсемен бірге платформадағы датасет браузеріңізде пайда болады.

Жергілікті деректер және LeRobot экспорты

Эпизодтар LeRobot форматында сақталады және экспортталады, бұл ашық көзді робот оқыту экожүйесінің көбі қабылдайтын алмасу форматы. Десктоп клиентімен жазылған датасет тікелей ACT, Diffusion Policy, SmolVLA немесе GR00T дәл баптауын оқытуға кете алады.

GR00T үшін LeRobot v2.1 қажет

GR00T дәл баптауды жоспарласаңыз, датасетіңізді LeRobot v2.1 форматында экспорттаңыз. GR00T басқа датасет нұсқаларын қабылдамайды, ұзақ жазба сессиясынан кейін мұны білу қуанышты болмайды.

CLI

CLI десктоп қосымшасынсыз-ақ дербес орнатылады, бұл оны басы жоқ (headless) компьютерлер мен скрипттер үшін дұрыс таңдау етеді. macOS пен Linux жүйесінде:

sh
curl -fsSL https://www.ay-robots.com/install.sh | sh
macOS және Linux

Windows жүйесінде, PowerShell-де:

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

CLI API кілтімен аутентификация жасайды. /dashboard/settings бетінде бірін жасаңыз; кілттерде ayr_live_ префиксі болады және оларды құпия сөз ретінде қарастыру керек, сондықтан оларды тапсырған скрипттеріңізде емес, қабық ортасында немесе құпия менеджерде сақтаңыз.

MCP: жергілікті және хостталған

MCP-үйлесімді көмекшімен немесе редактормен жұмыс істесеңіз, платформаға Model Context Protocol арқылы екі жолмен қол жеткізуге болады. Жергілікті сервер компьютеріңізде жұмыс істейді және бір командамен іске қосылады:

sh
ay-robots mcp
Жергілікті MCP серверін іске қосу

Хостталған сервер https://www.ay-robots.com/api/mcp мекенжайында орналасқан және Streamable HTTP хаттамасын қолданады. Оған жергілікті орнату қажет емес: MCP клиентіңізді осы URL мекенжайына бағыттап, есептік жазба деректеріңізбен жұмыс істеу үшін /dashboard/settings бетінен ayr_live_ API кілтімен аутентификация жасаңыз.

Жергілікті MCP серверХостталған MCP сервер
Қалай іске қосуCLI орнатқаннан кейін ay-robots mcpЕшнәрсе іске қосудың қажеті жоқ, https://www.ay-robots.com/api/mcp мекенжайына қосылыңыз
ТранспортMCP клиентіңіз іске қосатын жергілікті процессStreamable HTTP
АутентификацияCLI тіркелгі деректеріңізayr_live_ префиксі бар API кілті
Не үшін жарайдыЖергілікті компьютер мен жабдыққа қатысты жұмыс ағындарыКез келген жерден есептік жазба деректері, орнатудың қажеті жоқ

Жиі қойылатын сұрақтар

Жазу интернетсіз жұмыс істей ме?

Иә. Жазу толығымен жергілікті. Бастапқы кіру мен жұптау үшін, содан кейін тағы да жүктеп салғанда байланыс қажет, бірақ эпизодтарды түсіру кезінде қажет емес.

Десктоп клиенті қандай қолдарды анықтайды?

SO-100 (SO-ARM100) негізгі қол болып табылады және қосымша баптаусыз-ақ жұмыс істейді. Платформада қолдау көрсетілетін түрлердің толық тізімі үшін роботтар бетін қараңыз.

API кілтін қайдан алуға болады?

/dashboard/settings бетінен. Кілттер ayr_live_ бастауымен басталады және есептік жазбаңызға қол жеткізу береді, сондықтан оларды құпия сөз ретінде сақтаңыз, ашылып қалуы мүмкін кез келген кілтті жойыңыз.

Ешнәрсе орнатпай хостталған MCP серверін пайдалана аламын ба?

Иә. Ол https://www.ay-robots.com/api/mcp мекенжайында Streamable HTTP хаттамасын қолданады; сізге тек MCP клиенті мен API кілті қажет. Жергілікті сервер тек жұмыс ағыны жергілікті компьютеріңізге қатысты болғанда ғана қажет.