Cliente de escritorio y CLI
El cliente de escritorio sirve para grabar conjuntos de datos con un brazo sobre su propio escritorio: detecta el hardware, le guía por una captura de episodios limpia, y mantiene todo local hasta que decide subirlo. La CLI se incluye junto a él y también funciona como servidor MCP.
Última actualización 2026-08-09
Qué hace la aplicación de escritorio
La consola del navegador está pensada para el control remoto de robots que viven en la plataforma. El cliente de escritorio cubre la otra mitad del flujo de trabajo: usted, un brazo robótico sobre su escritorio y un conjunto de datos que quiere grabar usted mismo. Se conecta al brazo por USB, detecta las cámaras conectadas y le guía por la grabación episodio a episodio.
La detección es automática. Conecte un SO-100 y la aplicación encuentra el puerto serie y enumera los servos; las webcams conectadas aparecen en una vista previa para que pueda comprobar el encuadre antes de grabar nada. No hay ningún archivo de configuración que escribir ni ningún driver que buscar.
Todo lo que graba se escribe primero en el disco local. Nada sale de su equipo hasta que usted lo sube explícitamente, algo importante si sus episodios contienen cosas que aún no está listo para compartir, o si graba en un lugar sin una conexión fiable.
Descargar e instalar
La aplicación está disponible para macOS, Windows y Linux en /download. Instálela, inicie sesión con su cuenta de la plataforma y conecte el brazo. Si está emparejando un robot con la plataforma al mismo tiempo, la aplicación es también donde canjea el código de emparejamiento del asistente.
El flujo de grabación guiado
Grabar buenos datos de imitation learning es sobre todo cuestión de disciplina, y la aplicación aplica esa disciplina por usted. Cada episodio pasa por las mismas cinco etapas.
- 1Describir la tarea
Una frase clara, formulada siempre de la misma manera para la misma tarea. Las políticas condicionadas por lenguaje atienden a esta cadena de texto, así que "pick up the red cube and place it in the bowl" es mejor que "test 4".
- 2Reiniciar la escena
Lleve el brazo a su posición inicial y coloque los objetos. La vista previa de la cámara está ahí para que confirme el encuadre antes de comprometerse, no después.
- 3Grabar
Teleopere el brazo a través de la tarea con movimientos deliberados y suaves. Deténgase en cuanto la tarea esté completa en lugar de quedarse quieto en el encuadre.
- 4Revisar
Reproduzca el episodio antes de conservarlo. Descartar un episodio malo cuesta segundos; entrenar sobre él cuesta horas.
- 5Subir
Cuando esté satisfecho, suba el lote. Los episodios aparecen en su explorador de conjuntos de datos en la plataforma, junto a cualquier cosa grabada mediante sesiones remotas.
Datos locales y exportación a LeRobot
Los episodios se almacenan y se exportan en formato LeRobot, el formato de intercambio que acepta la mayor parte del ecosistema de código abierto para robot learning. Un conjunto de datos grabado con el cliente de escritorio puede pasar directamente al entrenamiento de ACT, Diffusion Policy, SmolVLA o ajustes finos de GR00T.
Si piensa hacer un ajuste fino de GR00T, exporte su conjunto de datos como LeRobot v2.1. GR00T no acepta otras versiones de conjunto de datos, y descubrirlo después de una larga sesión de grabación no tiene ninguna gracia.
La CLI
La CLI se instala de forma independiente, sin la aplicación de escritorio, lo que la convierte en la opción adecuada para equipos sin interfaz gráfica y para scripts. En macOS y Linux:
curl -fsSL https://www.ay-robots.com/install.sh | shEn Windows, en PowerShell:
irm https://www.ay-robots.com/install.ps1 | iexLa CLI se autentica con una clave de API. Cree una en /dashboard/settings; las claves llevan el prefijo ayr_live_ y deben tratarse como contraseñas, así que guárdelas en el entorno de su shell o en un gestor de secretos en lugar de en scripts que confirme en un repositorio.
MCP: local y alojado
Si trabaja con un asistente o editor compatible con MCP, la plataforma es accesible mediante el Model Context Protocol de dos maneras. El servidor local se ejecuta en su equipo y se inicia con un único comando:
ay-robots mcpEl servidor alojado vive en https://www.ay-robots.com/api/mcp y habla Streamable HTTP. No necesita instalación local: apunte su cliente MCP a la URL y autentíquese con una clave de API con prefijo ayr_live_ desde /dashboard/settings para trabajar con los datos de su cuenta.
| Servidor MCP local | Servidor MCP alojado | |
|---|---|---|
| Cómo ejecutarlo | ay-robots mcp tras instalar la CLI | Nada que ejecutar, conéctese a https://www.ay-robots.com/api/mcp |
| Transporte | Proceso local, iniciado por su cliente MCP | Streamable HTTP |
| Autenticación | Sus credenciales de la CLI | Clave de API con el prefijo ayr_live_ |
| Adecuado para | Flujos de trabajo que tocan su equipo y hardware locales | Datos de cuenta desde cualquier lugar, sin instalación |
Preguntas frecuentes
¿La grabación funciona sin conexión?▾
Sí. La grabación es completamente local. Necesita conectividad para el inicio de sesión inicial y el emparejamiento, y de nuevo cuando sube los datos, pero no mientras captura episodios.
¿Qué brazos detecta el cliente de escritorio?▾
El SO-100 (SO-ARM100) es el brazo principal y funciona de inmediato. Consulte la página de robots para ver la lista completa de tipos compatibles con la plataforma.
¿Dónde consigo una clave de API?▾
En /dashboard/settings. Las claves empiezan con ayr_live_ y otorgan acceso a su cuenta, así que guárdelas como contraseñas y revoque cualquier clave que haya podido quedar expuesta.
¿Puedo usar el servidor MCP alojado sin instalar nada?▾
Sí. Habla Streamable HTTP en https://www.ay-robots.com/api/mcp; solo necesita un cliente MCP y una clave de API. El servidor local solo es necesario cuando el flujo de trabajo involucra su equipo local.
Cómo almacena AY-Robots las grabaciones de teleoperación en formato LeRobot: estructura de episodios, el explorador del panel, fusión de subidas y el mercado.
Cree una cuenta en AY-Robots, elija el rol de cliente u operador, configure su primer entorno, empareje un robot con un código y ejecute su primera sesión.