אפליקציית הדסקטופ וה-CLI

אפליקציית הדסקטופ מיועדת להקלטת מערכי נתונים עם זרוע על השולחן שלכם: היא מזהה את החומרה, מובילה אתכם דרך תפיסת episode נקייה, ושומרת הכול מקומית עד שתחליטו להעלות. ה-CLI מגיע יחד איתה ומשמש גם כשרת MCP.

עדכון אחרון 2026-08-09

מה אפליקציית הדסקטופ עושה

ה-cockpit בדפדפן בנוי לשליטה מרחוק ברובוטים שחיים על הפלטפורמה. אפליקציית הדסקטופ מכסה את החצי השני של זרימת העבודה: אתם, זרוע רובוט על השולחן שלכם, ומערך נתונים שאתם רוצים להקליט בעצמכם. היא מתחברת לזרוע דרך USB, מזהה את המצלמות המחוברות, ומדריכה אתכם דרך הקלטה של episode אחר episode.

הזיהוי אוטומטי. חברו SO-100 והאפליקציה מוצאת את פורט הסריאלי ומונה את ה-servo; מצלמות רשת מחוברות מוצגות בתצוגה מקדימה כך שתוכלו לבדוק את המסגור לפני שתקליטו משהו. אין קובץ הגדרות לכתוב ואין driver לחפש.

כל מה שאתם מקליטים נכתב תחילה לדיסק המקומי. שום דבר לא עוזב את המחשב שלכם עד שתעלו במפורש, מה שחשוב אם ה-episodes שלכם מכילים דברים שאתם עדיין לא מוכנים לשתף, או אם אתם מקליטים במקום ללא חיבור אמין.

הורדה והתקנה

האפליקציה זמינה עבור macOS, Windows ו-Linux בכתובת /download. התקינו אותה, התחברו עם חשבון הפלטפורמה שלכם, וחברו את הזרוע. אם אתם מצמידים רובוט לפלטפורמה באותו זמן, זו גם המקום שבו אתם ממשים את קוד ההצמדה מהאשף.

תהליך ההקלטה המודרך

הקלטת נתוני imitation learning טובים היא בעיקר עניין של משמעת, והאפליקציה אוכפת את המשמעת עבורכם. כל episode עובר דרך אותן חמש תחנות.

  1. 1
    תארו את המשימה

    משפט אחד ברור, מנוסח באותה צורה בכל פעם עבור אותה משימה. policy מותנה-שפה מתייחס למחרוזת הזו, כך ש-"pick up the red cube and place it in the bowl" עדיף על "test 4".

  2. 2
    אפסו את הסצנה

    הזיזו את הזרוע לתנוחת ההתחלה שלה ומקמו את האובייקטים. התצוגה המקדימה של המצלמה שם כדי שתוכלו לאשר את המסגור לפני ההתחייבות, לא אחריה.

  3. 3
    הקליטו

    תפעלו את הזרוע מרחוק דרך המשימה בתנועות מכוונות וחלקות. עצרו ברגע שהמשימה הושלמה במקום להישאר בטל בתוך הפריים.

  4. 4
    סקרו

    הפעילו את ה-episode לפני ששומרים אותו. זריקת episode גרוע עולה שניות; אימון עליו עולה שעות.

  5. 5
    העלו

    כשאתם מרוצים, העלו את האצווה. ה-episodes מופיעים בדפדפן מערכי הנתונים שלכם בפלטפורמה, לצד כל מה שהוקלט דרך הפעלות מרחוק.

נתונים מקומיים וייצוא LeRobot

ה-episodes נשמרים ומיוצאים בפורמט LeRobot, פורמט ההחלפה שרוב מערכת הקוד הפתוח של למידת רובוטים מקבלת. מערך נתונים שהוקלט עם אפליקציית הדסקטופ יכול ללכת ישירות לאימון עבור ACT, Diffusion Policy, SmolVLA, או fine-tune של GR00T.

GR00T דורש LeRobot v2.1

אם אתם מתכננים לעשות fine-tune ל-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_ ויש להתייחס אליהם כמו לסיסמאות, אז שמרו אותם בסביבת ה-shell שלכם או במנהל סודות ולא בסקריפטים שאתם מבצעים להם commit.

MCP: מקומי ומאוחסן

אם אתם עובדים עם עוזר או עורך שתומך ב-MCP, הפלטפורמה נגישה דרך Model Context Protocol בשתי דרכים. השרת המקומי רץ על המחשב שלכם ומופעל בפקודה אחת:

sh
ay-robots mcp
הפעלת שרת ה-MCP המקומי

השרת המאוחסן חי בכתובת https://www.ay-robots.com/api/mcp ומדבר Streamable HTTP. הוא לא דורש התקנה מקומית: כוונו את לקוח ה-MCP שלכם לכתובת ואמתו עם מפתח API בקידומת ayr_live_ מתוך /dashboard/settings כדי לעבוד עם נתוני החשבון שלכם.

שרת MCP מקומישרת MCP מאוחסן
איך להריץay-robots mcp אחרי התקנת ה-CLIשום דבר להריץ, התחברו אל https://www.ay-robots.com/api/mcp
תעבורהתהליך מקומי, מופעל על ידי לקוח ה-MCP שלכםStreamable HTTP
אימותפרטי ה-CLI שלכםמפתח API עם הקידומת ayr_live_
מתאים לזרימות עבודה שנוגעות במחשב ובחומרה המקומיים שלכםנתוני חשבון מכל מקום, בלי התקנה

שאלות נפוצות

האם ההקלטה עובדת אופליין?

כן. ההקלטה כולה מקומית. אתם צריכים קישוריות עבור הכניסה הראשונית וההצמדה, ושוב כשאתם מעלים, אבל לא בזמן תפיסת ה-episodes.

אילו זרועות אפליקציית הדסקטופ מזהה?

ה-SO-100 (SO-ARM100) היא הזרוע העיקרית ועובדת מהקופסה. ראו את עמוד הרובוטים לרשימה המלאה של הסוגים הנתמכים בפלטפורמה.

איפה אני מקבל מפתח API?

תחת /dashboard/settings. המפתחות מתחילים ב-ayr_live_ ומעניקים גישה לחשבון שלכם, אז שמרו אותם כמו סיסמאות ובטלו כל מפתח שאולי נחשף.

האם אפשר להשתמש בשרת ה-MCP המאוחסן בלי להתקין שום דבר?

כן. הוא מדבר Streamable HTTP בכתובת https://www.ay-robots.com/api/mcp; כל מה שאתם צריכים זה לקוח MCP ומפתח API. השרת המקומי נחוץ רק כשזרימת העבודה נוגעת במחשב המקומי שלכם.