Masaüstü istemci ve CLI

Masaüstü uygulaması ne yapar

Tarayıcı kokpiti, platformda yaşayan robotların uzaktan kontrolü için tasarlanmıştır. Masaüstü istemci, iş akışının diğer yarısını kapsar: siz, masanızdaki bir robot kolu ve kendinizin kaydetmek istediği bir veri kümesi. USB üzerinden kola bağlanır, takılı kameraları algılar ve sizi bölüm bölüm kayıt sürecinde yönlendirir.

Algılama otomatiktir. Bir SO-100 takın, uygulama seri portu bulsun ve servoları numaralandırsın; bağlı web kameraları önizlemede görünür, böylece herhangi bir şey kaydetmeden önce kadrajı kontrol edebilirsiniz. Yazılması gereken bir yapılandırma dosyası veya aranması gereken bir sürücü yoktur.

Kaydettiğiniz her şey önce yerel diske yazılır. Siz açıkça yüklemedikçe hiçbir şey makinenizden çıkmaz; bu, bölümleriniz henüz paylaşmaya hazır olmadığınız şeyler içeriyorsa veya güvenilir bir bağlantının olmadığı bir yerde kayıt yapıyorsanız önemlidir.

İndirme ve kurulum

Uygulama macOS, Windows ve Linux için /download adresinde mevcuttur. Kurun, platform hesabınızla oturum açın ve kolu bağlayın. Aynı anda bir robotu platforma eşleştiriyorsanız, sihirbazdaki eşleştirme kodunu da bu uygulama üzerinden kullanırsınız.

Yönlendirmeli kayıt akışı

İyi imitation learning verisi kaydetmek büyük ölçüde disiplin meselesidir ve uygulama bu disiplini sizin yerinize uygular. Her bölüm aynı beş durağı geçer.

1. 1
   Görevi tanımlayın

   Aynı görev için her seferinde aynı şekilde ifade edilmiş, tek ve net bir cümle. Dile bağlı policy'ler bu dizeye dikkat eder, bu yüzden "kırmızı küpü al ve kâseye koy" ifadesi "test 4"ten daha iyidir.

2. 2
   Sahneyi sıfırlayın

   Kolu başlangıç pozuna getirin ve nesneleri yerleştirin. Kamera önizlemesi, kadrajı kayıttan sonra değil önce doğrulamanız için oradadır.

3. 3
   Kaydedin

   Kolu görev boyunca kasıtlı ve akıcı hareketlerle teleoperasyonla sürün. Görev bittiği an durun, kadrajda boşta beklemeyin.

4. 4
   İnceleyin

   Tutmadan önce bölümü tekrar oynatın. Kötü bir bölümü atmak saniyeler tutar; onun üzerinde eğitim yapmak saatler tutar.

5. 5
   Yükleyin

   Memnun olduğunuzda partiyi yükleyin. Bölümler, uzak oturumlar aracılığıyla kaydedilen her şeyin yanında, platformdaki veri kümesi tarayıcınızda görünür.

Yerel veri ve LeRobot dışa aktarımı

Bölümler, açık kaynak robot öğrenmesi ekosisteminin büyük bölümünün kabul ettiği değişim formatı olan LeRobot formatında saklanır ve dışa aktarılır. Masaüstü istemciyle kaydedilen bir veri kümesi doğrudan ACT, Diffusion Policy, SmolVLA veya GR00T ince ayarları için eğitime girebilir.

CLI

CLI, masaüstü uygulaması olmadan bağımsız olarak kurulur; bu da onu başsız (headless) makineler ve betikler için doğru seçim yapar. macOS ve Linux üzerinde:

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

Windows'ta, PowerShell içinde:

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

CLI, bir API anahtarıyla kimlik doğrular. Bunu /dashboard/settings altında oluşturun; anahtarlar ayr_live_ önekini taşır ve parola gibi işlem görmelidir, bu yüzden onları commit ettiğiniz betikler yerine kabuk ortam değişkenlerinde veya bir gizli anahtar yöneticisinde saklayın.

MCP: yerel ve barındırılan

MCP destekli bir asistan veya editörle çalışıyorsanız, platforma Model Context Protocol üzerinden iki şekilde erişebilirsiniz. Yerel sunucu makinenizde çalışır ve tek bir komutla başlatılır:

ay-robots mcp

Barındırılan sunucu https://www.ay-robots.com/api/mcp adresinde yaşar ve Streamable HTTP konuşur. Yerel kurulum gerektirmez: MCP istemcinizi bu URL'ye yönlendirin ve hesap verilerinizle çalışmak için /dashboard/settings altındaki bir ayr_live_ API anahtarıyla kimlik doğrulayın.

Sık sorulan sorular