quackd
Agente da riga di comando che permette a un LLM di comandare Microduck, bracci LeRobot e altri robot
Licenza
Apache-2.0
Panoramica
quackd è una riga di comando che mette un modello linguistico di grandi dimensioni al comando dei robot che possiedi. Ogni robot si collega tramite un adattatore che dichiara che cos'è il corpo e quali abilità ha; l'LLM guarda la telecamera e lo stato del robot e sceglie una di quelle abilità alla volta, e i controller del robot stesso si occupano di camminare e afferrare. Comanda Microduck di Pollen Robotics, Open Duck Mini v2, un braccio LeRobot SO-101, XLeRobot, AlohaMini, ToddlerBot e qualsiasi base ROS 2 da un laptop, da soli o in gruppo, e può essere pilotato da Claude tramite MCP. Apache-2.0, di Rok Benko.
quackd tiene separate le abilità del robot e il giudizio dell'LLM. Un adattatore pubblica un manifest di ciò che un corpo sa fare, come sedersi, alzarsi, calciare e fare qua qua su un Microduck, oppure prendere e posare su un braccio, e un verbo che non è nel manifest non esiste. A ogni turno l'LLM pilota vede il fotogramma della telecamera, lo stato e l'ultimo risultato e sceglie un verbo con i suoi parametri; quackd lo verifica rispetto a una allowlist, a un budget e a regole di conferma, lo esegue, osserva il risultato e chiede di nuovo finché il compito non è completato o giudicato impossibile.
Il pilota può essere un modello di uno di dodici fornitori cloud oppure un modello locale tramite Ollama, vLLM, llama.cpp o LM Studio, e Claude può comandare un robot o un intero stormo attraverso il server MCP di quackd. Più robot possono condividere un compito, dividendosi il lavoro, e le note delle esecuzioni precedenti vengono passate a quella successiva.
Senza un robot lo si può provare in un simulatore 2D a cartoni animati, in MuJoCo con la policy di camminata addestrata di Microduck, nel simulatore del braccio SO-101 o in una demo nel browser. Il README indica per ogni robot fin dove è davvero arrivato: alla versione 0.32, uno dei nove corpi, un braccio SO-101, ha funzionato su hardware reale.
Perché è importante
I piccoli robot aperti come Microduck e Open Duck Mini vengono forniti con una manciata di movimenti addestrati, ma senza un modo per concatenarli in un compito. quackd dà loro un cervello esterno senza riaddestrare nulla: l'LLM pianifica, i controller del robot muovono, e gli stessi comandi funzionano su corpi molto diversi. È anche insolitamente onesto su che cosa ha funzionato su hardware e che cosa solo in simulazione.
Il problema che risolve
Ogni robot aperto ha il proprio SDK e i propri comportamenti fissi, quindi chiedere a uno di trovare una palla e calciarla, o a diversi di lavorare insieme, significa scrivere codice di raccordo per ogni corpo. quackd mette davanti a tutti una sola riga di comando e un solo insieme di regole, così un obiettivo espresso a parole diventa una sequenza delle abilità reali del robot.
Punti chiave
- Un LLM sceglie a ogni passo una delle abilità proprie del robot; i controller del robot eseguono il movimento
- Nove adattatori per robot, tra cui Microduck, Open Duck Mini v2, un braccio SO-101, XLeRobot e qualsiasi base ROS 2
- Funziona con dodici fornitori di LLM cloud o con modelli locali, e con Claude tramite MCP
- Più robot possono condividere un compito, e la memoria conserva le note tra un'esecuzione e l'altra
- I simulatori 2D, MuJoCo e nel browser permettono di provarlo senza un robot
A chi si rivolge
- Possessori di piccoli robot aperti come Microduck, Open Duck Mini o un braccio SO-101 che vogliono far loro svolgere compiti in linguaggio naturale
- Sviluppatori che costruiscono agenti LLM che agiscono attraverso abilità reali dei robot, anche tramite MCP da Claude
- Ricercatori che sperimentano il coordinamento multi-robot in simulazione prima dell'hardware
Limiti
- Solo uno dei nove corpi, un braccio SO-101, ha funzionato su hardware reale (15 e 23 settembre 2026); Microduck stesso ha funzionato solo in simulazione
- Il simulatore predefinito è un cartone animato che verifica il ciclo dell'agente, non la fisica; solo il Microduck e il braccio hanno simulatori fisici
- Il successo di un'esecuzione singola è dichiarato dall'LLM stesso, ed è verificato rispetto alla verità di riferimento solo in simulazione
- Gli stormi, il rilevamento in LAN e il passaporto da robot a robot hanno funzionato solo su una macchina o in simulazione
- Ogni passo è una chiamata all'LLM, quindi le esecuzioni costano tempo di API e denaro, a meno di usare un modello locale
- Un progetto giovane: creato ad agosto 2026 e in rapida evoluzione