text-to-cad
Fa progettare pezzi in CAD Python ad agenti IA ed esporta robot verso MuJoCo
Licenza
MIT
Codice e skill: MIT, letto nel file LICENSE di earthtojake/text-to-cad e nel file LICENSE di ogni cartella delle skill (copyright Thompson Labs LLC). App di agenti: text-to-cad richiede un'app di agente IA separata, con condizioni proprie. Servizi: SendCutSend e Bambu Lab sono servizi di terzi con condizioni proprie; le skill verificano e preparano file e non effettuano ordini. Telemetria: conteggi d'uso e segnalazioni di crash vanno ad api.texttocad.dev se non disattivati; modelli, prompt e percorsi dei file non vengono inviati. Immagine della scheda: un ritaglio dell'immagine di anteprima social del progetto stesso, non coperta dalla licenza del codice. Verificato il 2026-11-13 sui file LICENSE, sul README e sull'informativa sulla privacy.
Panoramica
text-to-cad è un plugin open source che permette ad agenti di programmazione IA come Claude Code, Codex, Cursor e Gemini CLI di progettare pezzi e assiemi fisici. L'agente scrive ogni modello come script Python con la libreria build123d sul kernel OpenCASCADE, lo esegue e mostra il risultato in un visualizzatore CAD locale. I modelli si esportano come file STEP, STL, 3MF, GLB o DXF. Altre skill verificano se un pezzo si può lavorare a macchina, tagliare e piegare, stampare a iniezione o stampare in 3D, eseguono verifiche di resistenza con CalculiX, disegnano tavole quotate in PDF, creano render con Blender, progettano circuiti stampati in KiCad, eseguono lo slicing con OrcaSlicer e controllano i file secondo la guida agli ordini di SendCutSend. Per la robotica scrive descrizioni di robot in URDF, SRDF e MJCF a partire dai giunti e dai materiali di un modello, e dalla release 0.11.8 di novembre 2026 supporta MuJoCo 4: masse e inerzie vengono dal CAD, una verifica compila il modello in MuJoCo e robot e scene si compongono in Python. Il progetto è di earthtojake, con licenza MIT, e tutto gira sul computer dell'utente.
text-to-cad è un insieme di skill per agenti più un server CAD locale che un agente di programmazione chiama tramite MCP. Il suo script di installazione lo configura in ogni app di agenti che trova: Claude Code, Claude Desktop, Codex, Cursor, Grok Build e Gemini CLI ricevono il plugin, e una quindicina di altri agenti, tra cui GitHub Copilot, Windsurf, Cline e Zed, solo le skill. Lo strumento vero e proprio è il pacchetto Python cad, eseguito tramite uv. Il sito del progetto è texttocad.dev.
Un modello è uno script Python scritto con build123d sul kernel OpenCASCADE; la skill CAD fa sì che l'agente lo esegua, lo mostri nel visualizzatore CAD e lo esporti in STEP, STL, 3MF o GLB, oppure come profili DXF e sviluppi in piano per il taglio laser e a getto d'acqua. Gli assiemi possono avere giunti e animazioni. Le altre skill coprono le verifiche di fabbricazione per lavorazione meccanica, lamiera, stampaggio e stampa 3D, le verifiche statiche lineari di resistenza (metodo degli elementi finiti con CalculiX), i disegni tecnici in PDF, i render con Blender, i circuiti stampati KiCad, lo slicing con OrcaSlicer con invio alle stampanti Bambu Lab e un controllo preliminare per gli ordini a SendCutSend.
La skill di simulazione robotica trasforma i giunti, i materiali e i sistemi di riferimento con nome di un modello in un URDF per ROS 2, un SRDF per MoveIt e un MJCF per MuJoCo. La release 0.11.8, dell'11 novembre 2026, ha aggiunto il supporto a MuJoCo 4.0.0:
- Massa, centro di massa e inerzia di ogni link vengono dai materiali dei pezzi attraverso il kernel CAD, e un solo comando esporta il robot come MJCF o URDF. - Una semplice funzione Python compie le scelte di simulazione sulla specifica propria di MuJoCo: forme di collisione adattate come primitive o suddivise in inviluppi convessi con CoACD (decomposizione convessa), smorzamento dei giunti, attuatori e sensori. - Il comando cad mujoco check compila il file con MuJoCo e segnala pezzi che si compenetrano a riposo, scale errate, giunti fuori dal loro intervallo e che cosa collide con che cosa. - Le scene si compongono in Python, per esempio una pinza progettata in CAD montata su un braccio di altra provenienza con un blocco da prendere, e si aprono in MuJoCo Studio nel browser. - Un comando ranges trova i finecorsa di ogni giunto muovendolo finché i suoi pezzi si toccano.
I progetti di esempio MuJoCo portano i file STEP del costruttore del braccio SO-101 e del Trossen WidowX AI attraverso questo processo e confrontano il risultato con i modelli fatti a mano di MuJoCo Menagerie: la massa totale si scosta dell'1,3% e del 2,7%. Il progetto li chiama esempi, non un benchmark.
Perché è importante
La maggior parte dei robot nasce come pezzi in CAD, e passare da quei pezzi a un modello di simulazione di solito richiede un programma CAD commerciale e un convertitore separato come onshape-to-robot. text-to-cad tiene l'intera catena come codice che un agente IA scrive e una persona può leggere: il pezzo, l'assieme, i giunti, le masse e il modello MuJoCo nascono dagli stessi script Python, così una modifica di progetto è una modifica e una nuova esecuzione. Il suo lavoro su MuJoCo è verificato su robot reali, l'SO-101 e il WidowX AI, invece che su esempi giocattolo. Come SolidCraft, è prima di tutto CAD generico: la robotica è una skill su otto, utile soprattutto a chi lavora già con un agente di programmazione.
Il problema che risolve
Progettare un pezzo di robot e simulare il robot di cui fa parte di solito richiede un programma CAD, lavoro manuale per ottenere masse e inerzie corrette e un convertitore verso URDF o MJCF da rieseguire dopo ogni modifica. text-to-cad permette a un agente IA di scrivere i pezzi come script Python, verificarne la fabbricabilità e generare le descrizioni del robot e le scene MuJoCo dagli stessi script, con le proprietà fisiche prese dal CAD.
Punti chiave
- Plugin e skill con cui agenti di programmazione IA scrivono pezzi e assiemi come script Python in build123d
- Esporta STEP, STL, 3MF, GLB e DXF, con verifiche per lavorazione meccanica, lamiera, stampaggio e stampa 3D
- Scrive URDF, SRDF e MJCF dai giunti e dai materiali di un modello, con masse e inerzie dal CAD
- Supporto a MuJoCo 4 dalla release 0.11.8: una funzione MuJoCo, una verifica del modello e scene composte in Python
- Fa anche verifiche di resistenza con CalculiX, disegni PDF, render con Blender e circuiti KiCad
- Licenza MIT; gira in locale senza account e invia statistiche d'uso se non vengono disattivate
A chi si rivolge
- Costruttori di robot che usano già un agente di programmazione IA e vogliono fargli progettare pezzi stampati o lavorati
- Ricercatori che hanno bisogno di un modello MuJoCo o URDF di un robot di cui hanno il CAD
- Maker che vogliono far verificare i pezzi per la stampa 3D o la lamiera prima di ordinarli
- Sviluppatori che tengono i progetti hardware come codice sotto controllo di versione
Limiti
- Serve un'app di agente IA come Claude Code, Codex o Cursor; sono prodotti separati con condizioni e costi propri
- Prima di tutto CAD generico: la robotica è una skill su otto, e il supporto a MuJoCo è arrivato solo a novembre 2026
- L'esportazione MJCF semplice non contiene attuatori, dinamica dei giunti né forme di collisione scelte; si scrivono a mano in una funzione MuJoCo
- Gli esempi MuJoCo non sono un benchmark: i guadagni dei loro attuatori sono scelti perché il robot mantenga una posa, non misurati
- MuJoCo Studio, usato per vedere una scena, è in ascolto su tutte le interfacce di rete senza autenticazione
- La decomposizione convessa con CoACD non è disponibile su Mac Intel, Windows on ARM e Linux musl
- Le verifiche di resistenza coprono solo carichi statici lineari
- L'installazione esegue uno script inviato alla shell tramite pipe e scarica un kernel CAD di circa 240 MB
- Statistiche d'uso e segnalazioni di crash vengono inviate per impostazione predefinita; si possono disattivare
- Per lo più opera di un solo maintainer, con release a pochi giorni l'una dall'altra