Client de bureau et CLI

Ce que fait l'application de bureau

Le cockpit du navigateur est conçu pour le contrôle à distance des robots présents sur la plateforme. Le client de bureau couvre l'autre moitié du flux de travail : vous, un bras robotique sur votre bureau, et un jeu de données que vous voulez enregistrer vous-même. Il se connecte au bras par USB, détecte les caméras branchées et vous guide dans l'enregistrement épisode par épisode.

La détection est automatique. Branchez un SO-100 et l'application trouve le port série et énumère les servomoteurs ; les webcams connectées apparaissent dans un aperçu pour que vous puissiez vérifier le cadrage avant d'enregistrer quoi que ce soit. Il n'y a aucun fichier de configuration à écrire ni aucun pilote à dénicher.

Tout ce que vous enregistrez est d'abord écrit sur le disque local. Rien ne quitte votre machine tant que vous n'envoyez pas explicitement les données, ce qui compte si vos épisodes contiennent des éléments que vous n'êtes pas prêt à partager, ou si vous enregistrez dans un endroit sans connexion fiable.

Téléchargement et installation

L'application est disponible pour macOS, Windows et Linux sur /download. Installez-la, connectez-vous avec votre compte de la plateforme et branchez le bras. Si vous appairez un robot à la plateforme en même temps, c'est aussi dans l'application que vous utilisez le code d'appairage généré par l'assistant.

Le parcours d'enregistrement guidé

Enregistrer de bonnes données d'apprentissage par imitation est avant tout une question de discipline, et l'application impose cette discipline à votre place. Chaque épisode traverse les cinq mêmes étapes.

1. 1
   Décrire la tâche

   Une phrase claire, formulée de la même façon à chaque fois pour une même tâche. Les politiques conditionnées par le langage se fondent sur cette chaîne de caractères, donc "pick up the red cube and place it in the bowl" vaut mieux que "test 4".

2. 2
   Réinitialiser la scène

   Déplacez le bras vers sa position de départ et disposez les objets. L'aperçu caméra est là pour confirmer le cadrage avant de vous lancer, pas après.

3. 3
   Enregistrer

   Téléopérez le bras tout au long de la tâche avec des mouvements délibérés et fluides. Arrêtez-vous dès que la tâche est terminée au lieu de rester immobile dans le cadre.

4. 4
   Relire

   Relisez l'épisode avant de le conserver. Écarter un mauvais épisode coûte quelques secondes ; s'entraîner dessus coûte des heures.

5. 5
   Envoyer

   Une fois satisfait, envoyez le lot. Les épisodes apparaissent dans votre explorateur de jeux de données sur la plateforme, aux côtés de tout ce qui a été enregistré via des sessions à distance.

Données locales et export LeRobot

Les épisodes sont stockés et exportés au format LeRobot, le format d'échange accepté par la majeure partie de l'écosystème open source du robot learning. Un jeu de données enregistré avec le client de bureau peut être utilisé directement pour entraîner ACT, Diffusion Policy, SmolVLA ou un fine-tune de GR00T.

La CLI

La CLI s'installe de façon autonome, sans l'application de bureau, ce qui en fait le bon choix pour les machines headless et les scripts. Sur macOS et Linux :

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

Sous Windows, dans PowerShell :

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

La CLI s'authentifie avec une clé API. Créez-en une dans /dashboard/settings ; les clés portent le préfixe ayr_live_ et doivent être traitées comme des mots de passe, donc conservez-les dans votre environnement shell ou un gestionnaire de secrets plutôt que dans des scripts versionnés.

MCP : local et hébergé

Si vous travaillez avec un assistant ou un éditeur compatible MCP, la plateforme est accessible via le Model Context Protocol de deux façons. Le serveur local s'exécute sur votre machine et se lance avec une seule commande :

ay-robots mcp

Le serveur hébergé se trouve à l'adresse https://www.ay-robots.com/api/mcp et utilise le protocole Streamable HTTP. Il ne nécessite aucune installation locale : pointez votre client MCP vers cette URL et authentifiez-vous avec une clé API ayr_live_ depuis /dashboard/settings pour accéder aux données de votre compte.

Questions fréquentes