Il tuo agente può passarti un STEP: text-to-cad e il codice come geometria

La parte che non è mai stata testo

Gli agenti di coding scrivono software perché il software è testo. Questo singolo fatto spiega quasi tutto quello in cui sono bravi. Spiega anche perché sono stati inutili per il lavoro meccanico: una staffa non è testo, uno spessore di parete non è testo, e un file STEP non è decisamente testo, anche se tecnicamente lo è.

text-to-cad, un plugin con licenza MIT di earthtojake che questo mese è stato nella classifica trending di GitHub intorno ai 18,600 stars, risolve la contraddizione con un trucco vecchio: se la cosa non è testo, fai una rappresentazione testuale della cosa. In questo caso, uno script Python parametrico.

Il compito dell'agente non è immaginare un modello 3D. È scrivere codice che un kernel geometrico possa eseguire. Quella distinzione è tutto il prodotto.

Come gira davvero il loop

Sotto c'è cadgen, un pacchetto Python su PyPI costruito su build123d, che a sua volta guida Open CASCADE, la stessa famiglia di kernel geometrici che usano i CAD seri. Un modello è un semplice script Python: una funzione decorata con una definizione step che restituisce una forma.

Metti che vuoi un supporto per camera con pareti da 3mm e due fori M3. Lo descrivi a parole. L'agente scrive lo script con parametri per spessore parete, diametro fori e interasse. cadgen lo esegue e scrive STEP, più STL, 3MF o GLB se lo chiedi. Vuoi spostare un foro? Cambi un numero, rilancia. Il sorgente del modello resta nel repository accanto al resto del codice, quindi si può diffare, revisionare e revertare come qualsiasi altra cosa.

È la differenza tra geometria esatta e una mesh plausibile. Un generatore di mesh produce una superficie che sembra una staffa. Un modellatore solido produce una staffa con uno spessore di parete noto, e un'officina accetta un file STEP mentre declina con garbo il tuo STL di una superficie curva con 4,000 triangoli.

Il plugin si occupa anche delle parti noiose che decidono se un progetto è reale. Esegue controlli di design for manufacturing e design for additive, spessore parete, sbalzi, angoli di sformo, sottosquadri, e per ogni rilievo riporta la regola che ci sta dietro invece di un avviso nudo e crudo. Genera disegni tecnici quotati in PDF con viste, linee nascoste, richiami fori e cartiglio. Scrive profili DXF per il taglio laser, slicia G-code con OrcaSlicer, manda le stampe alle macchine Bambu Lab, fa i controlli pre-upload per SendCutSend e scrive file URDF, SRDF e SDF per descrizioni di robot e mondi di simulatore.

C'è anche un viewer locale. Nelle app che lo supportano, il modello compare come card in chat; altrove ti arriva un link a localhost.

Perché questo generalizza

Il caso CAD è specifico, il pattern no. Qualsiasi dominio con due proprietà può essere affidato a un agente di coding: una rappresentazione in codice dell'artefatto, e un checker che dice se l'artefatto è valido.

I pezzi meccanici hanno entrambe. Lo script è la rappresentazione, il controllo di fabbricabilità è il validatore. Le pagine web hanno entrambe, HTML e un browser. L'infrastruttura ha entrambe, configurazione e un plan. Il video, fino a poco fa, non ne aveva nessuna in una forma che un agente potesse eseguire, ed è esattamente il buco che progetti come HyperFrames stanno riempiendo.

Dove un dominio non ha il checker, gli agenti producono spazzatura con sicurezza. È per questo che "AI for 3D" è bloccata alle preview: non c'era validatore tra "sembra una sedia" e "si può fabbricare".

L'altra metà del pattern è l'esecuzione locale. cadgen gira sulla tua macchina, contro un kernel geometrico vero. Nella fase geometrica non c'è niente di approssimato da una rete neurale. L'agente porta l'intenzione parametrica, il kernel porta la verità.

Le tasse di adozione, che sono reali

Due cose morderanno, e tutte e due sono documentate nel repository invece che scoperte a proprie spese, il che va a credito degli autori.

Windows 11 ha una trappola tutta sua. Il binding Python del kernel CAD include un modulo nativo non firmato, e Smart App Control di Windows 11, attivo di default sulle installazioni pulite, lo blocca. Da lì ogni comando fallisce con un errore di caricamento DLL. Non c'è eccezione per singola app. Le opzioni: spegnere Smart App Control, che su alcuni sistemi si torna indietro solo reinstallando Windows, oppure far girare le skill CAD sotto WSL. C'è un comando doctor che rileva il caso, quindi almeno lo scopri in fretta.

La telemetria è attiva di default. Il README la documenta con un dettaglio inusuale, e l'istinto è giusto. Cosa viene inviato: versioni, origine dell'installazione, sistema operativo, quale app agente usi, e conteggi tipo quante volte è stato chiamato ogni tool e quanti modelli sono stati costruiti, più motivi di fallimento scelti da una lista fissa invece che dal testo dell'errore. I crash report includono il tipo di errore e dove nel codice si è rotto. Tutto è etichettato con un ID installazione casuale e salvato su PostHog; il server ricava il paese dall'IP e non conserva l'indirizzo. Cosa non viene mai inviato: nomi di file, percorsi, contenuti dei file, prompt. Si spegne con un comando, che cancella anche quanto già inviato, e non parte niente in CI né da un'installazione di sviluppo.

Sono entrambe cose normali per un progetto giovane ed entrambe costano adozione. Un vendor CAD commerciale non spedirebbe né l'una né l'altra.

Per cosa non è

Forme organiche. Personaggi, action figure, forme scolpite, tutto dove la forma è il punto e non la funzione: quello è territorio di mesh, e un modello image-to-3D basato su mesh è lo strumento migliore. Provare a descrivere un drago a parametri è un pomeriggio buttato.

Non sostituisce nemmeno la firma dell'ingegnere. La skill DFM è una revisione guidata, non una certificazione. Se un pezzo deve reggere il peso di una persona, un ingegnere umano firma ancora il disegno. Il loop finisce con qualcuno che paga una fattura, e quello è probabilmente il posto giusto per l'umano.

Il repository è giovane e corre: creato ad aprile 2026, oltre 1,400 commits, un pacchetto PyPI con decine di release, e tre versioni uscite in due giorni a inizio ottobre. Questo ritmo è un pregio se ti piacciono le skill nuove e un rischio se ti serve stabilità.

La frase nel README che conta

Seppellita nella descrizione c'è un'affermazione facile da saltare: il plugin dà al tuo agente un vero workflow CAD. Non una demo, non un wrapper di prompt, un workflow con rappresentazione, esecutore, validatore e passaggio a un fabbricante.

È la forma di cosa che rende gli agenti utili fuori dal software. Non un modello che sa di staffe, ma un loop in cui il modello scrive qualcosa di eseguibile, qualcos'altro lo controlla, e l'output è un file che un altro sistema accetta. L'agente non deve essere bravo in CAD. Deve essere bravo in codice, e il dominio deve avere un compilatore.

L'ingegneria meccanica è arrivata prima perché il compilatore ha cinquant'anni e il validatore è un insieme di regole di produzione. Ogni altro dominio che si prende quei due pezzi, entro un anno avrà questo aspetto.