robot2: uno stack di controllo HTTP semplice per guidare un SO-101 da un agente
- Costruttore: Alex Nichol
Alex Nichol ha riscritto da zero in Go il suo stack di robotica domestica e lo ha messo interamente dietro una piccola API HTTP, poi vi ha collegato un agente generico. Il repository si descrive senza giri di parole come "un tentativo di riscrivere gran parte del mio stack di robotica domestica in modo più pulito (guidato da una persona)": e la guida umana è proprio il punto, in un progetto il cui unico scopo è lasciare che sia un modello a guidare il braccio.
L'API
Tre gruppi di endpoint, tutti con risposte JSON nella forma {"data": ...} o {"error": ...}, con codici di stato diversi da 200 che distinguono i guasti del robot dalle richieste errate:
- Motori: /motor/names, /motor/status, /motor/limits, /motor/move (posizioni grezze da 0 a 4095) e /motor/stoprelax, una chiamata bloccante che sospende il rilassamento graduale che altrimenti assesterebbe i motori nella direzione della coppia. Quest'ultima esiste perché il braccio non si abbassi mentre il modello sta pensando. - Cinematica: /kinematics/limitsangles, /kinematics/currentangles e /kinematics/move, che accetta tutti gli angoli dei giunti in radianti e richiede che siano specificati tutti. - Fotocamere: /camera/tracknames e /camera/snapshot, che restituisce i byte JPEG grezzi di una traccia indicata per nome.
È tutta la superficie di cui un agente ha bisogno: leggere gli angoli dei giunti, guardare attraverso una fotocamera, comandare nuovi angoli.
Cosa c'è nel repository
Tutto in Go, con pacchetti per l'API, l'acquisizione video tramite V4L2 e la cinematica, più una serie di strumenti a riga di comando che rivelano cosa abbia davvero richiesto la costruzione: calibrate e calibrate_single, fit_to_table e manual_table_fit per determinare dove si trova il tavolo, ik_move per il posizionamento in cinematica inversa, kinematics_log, placement_data per registrare i posizionamenti, setid per assegnare gli ID dei servo e timelapse.
Perché conta il design degli endpoint
La maggior parte delle dimostrazioni agente-braccio si appoggia a un framework esistente. Questa parte dall'osservazione che un agente è qualcosa che fa richieste HTTP, e costruisce la superficie più piccola che gli permetta di fare un lavoro utile: un design che un lettore può replicare su un braccio diverso in un pomeriggio.
Dettagli
- arm: SO-101
- agent: GPT-6 Astra
- licence: No licence file — all rights reserved by default
- notable: stoprelax endpoint holds position while the model is thinking
- language: Go
- difficulty: Advanced
- api_surface: /motor, /kinematics, /camera over HTTP with JSON
- repository_opened: 18 July 2026
Foto e video
- unixpickle/robot2: The Go control stack: HTTP API, camera capture, kinematics, and the calibration and table-fitting tools.
- Astra arranges a circle: The agent arranging blocks into a circle on the table through the HTTP API.
Link
- Costruttore: https://github.com/unixpickle