Εφαρμογή desktop και CLI

Τι κάνει η εφαρμογή desktop

Το cockpit του browser είναι φτιαγμένο για απομακρυσμένο έλεγχο ρομπότ που ζουν στην πλατφόρμα. Η εφαρμογή desktop καλύπτει το άλλο μισό της ροής εργασίας: εσάς, έναν βραχίονα ρομπότ στο γραφείο σας, και ένα dataset που θέλετε να καταγράψετε μόνοι σας. Συνδέεται με τον βραχίονα μέσω USB, εντοπίζει τις συνδεδεμένες κάμερες, και σας καθοδηγεί στην καταγραφή επεισόδιο προς επεισόδιο.

Ο εντοπισμός είναι αυτόματος. Συνδέστε έναν SO-100 και η εφαρμογή βρίσκει τη σειριακή θύρα και απαριθμεί τα servo· οι συνδεδεμένες webcams εμφανίζονται σε προεπισκόπηση ώστε να ελέγξετε το πλαισίωμα πριν καταγράψετε οτιδήποτε. Δεν υπάρχει αρχείο ρυθμίσεων για να γράψετε ούτε driver για να αναζητήσετε.

Οτιδήποτε καταγράφετε γράφεται πρώτα στον τοπικό δίσκο. Τίποτα δεν φεύγει από το μηχάνημά σας μέχρι να ανεβάσετε ρητά, κάτι που έχει σημασία αν τα επεισόδιά σας περιέχουν κάτι που δεν είστε έτοιμοι να μοιραστείτε, ή αν καταγράφετε κάπου χωρίς αξιόπιστη σύνδεση.

Λήψη και εγκατάσταση

Η εφαρμογή διατίθεται για macOS, Windows και Linux στο /download. Εγκαταστήστε την, συνδεθείτε με τον λογαριασμό σας στην πλατφόρμα, και συνδέστε τον βραχίονα. Αν συζευγνύετε ταυτόχρονα ένα ρομπότ με την πλατφόρμα, η εφαρμογή είναι επίσης εκεί όπου εξαργυρώνετε τον κωδικό σύζευξης από τον οδηγό.

Η καθοδηγούμενη ροή καταγραφής

Η καταγραφή καλών δεδομένων μάθησης μίμησης είναι κυρίως θέμα πειθαρχίας, και η εφαρμογή επιβάλλει την πειθαρχία για εσάς. Κάθε επεισόδιο περνά από τους ίδιους πέντε σταθμούς.

1. 1
   Περιγράψτε την εργασία

   Μία σαφής πρόταση, διατυπωμένη με τον ίδιο τρόπο κάθε φορά για την ίδια εργασία. Οι policies υπό γλωσσική συνθήκη προσέχουν αυτή τη συμβολοσειρά, οπότε το "pick up the red cube and place it in the bowl" νικά το "test 4".

2. 2
   Επαναφέρετε τη σκηνή

   Μετακινήστε τον βραχίονα στην αρχική του στάση και τοποθετήστε τα αντικείμενα. Η προεπισκόπηση κάμερας υπάρχει για να επιβεβαιώσετε το πλαισίωμα πριν δεσμευτείτε, όχι μετά.

3. 3
   Καταγράψτε

   Τηλεχειριστείτε τον βραχίονα μέσα από την εργασία με σκόπιμες, ομαλές κινήσεις. Σταματήστε μόλις η εργασία ολοκληρωθεί αντί να παραμένετε αδρανείς μέσα στο κάδρο.

4. 4
   Ελέγξτε

   Αναπαράγετε το επεισόδιο πριν το κρατήσετε. Η απόρριψη ενός κακού επεισοδίου κοστίζει δευτερόλεπτα· η εκπαίδευση πάνω σε αυτό κοστίζει ώρες.

5. 5
   Ανεβάστε

   Όταν είστε ικανοποιημένοι, ανεβάστε τη δέσμη. Τα επεισόδια εμφανίζονται στον browser dataset σας στην πλατφόρμα, δίπλα σε ό,τι έχει καταγραφεί μέσω απομακρυσμένων συνεδριών.

Τοπικά δεδομένα και εξαγωγή LeRobot

Τα επεισόδια αποθηκεύονται και εξάγονται σε μορφή LeRobot, τη μορφή ανταλλαγής που δέχεται το μεγαλύτερο μέρος του οικοσυστήματος ανοιχτού κώδικα για μάθηση ρομπότ. Ένα dataset που καταγράφηκε με την εφαρμογή desktop μπορεί να πάει κατευθείαν σε εκπαίδευση για ACT, Diffusion Policy, SmolVLA, ή fine-tunes του GR00T.

Το CLI

Το CLI εγκαθίσταται αυτόνομα, χωρίς την εφαρμογή desktop, κάτι που το κάνει τη σωστή επιλογή για headless μηχανήματα και scripts. Σε macOS και Linux:

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

Σε Windows, στο PowerShell:

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

Το CLI αυθεντικοποιείται με ένα κλειδί API. Δημιουργήστε ένα στο /dashboard/settings· τα κλειδιά φέρουν το πρόθεμα ayr_live_ και πρέπει να αντιμετωπίζονται σαν κωδικοί πρόσβασης, οπότε κρατήστε τα στο shell environment σας ή σε έναν secret manager αντί σε scripts που κάνετε commit.

MCP: τοπικά και hosted

Αν εργάζεστε με έναν βοηθό ή editor συμβατό με MCP, η πλατφόρμα είναι προσβάσιμη μέσω του Model Context Protocol με δύο τρόπους. Ο τοπικός server τρέχει στο μηχάνημά σας και ξεκινά με μία μόνο εντολή:

ay-robots mcp

Ο hosted server ζει στο https://www.ay-robots.com/api/mcp και μιλά Streamable HTTP. Δεν χρειάζεται καμία τοπική εγκατάσταση: κατευθύνετε τον MCP client σας στο URL και αυθεντικοποιηθείτε με ένα κλειδί API ayr_live_ από το /dashboard/settings για να δουλέψετε με τα δεδομένα του λογαριασμού σας.

Συχνές ερωτήσεις