Seu agente pode te entregar um STEP: text-to-cad e o código como geometria

A parte que nunca foi texto

Agentes de código escrevem software porque software é texto. Esse único fato explica quase tudo o que eles fazem bem. Também explica por que eles foram inúteis para trabalho mecânico: um suporte não é texto, uma espessura de parede não é texto, e um arquivo STEP definitivamente não é texto, ainda que tecnicamente seja.

text-to-cad, um plugin com licença MIT do earthtojake que passou este mês na lista de trending do GitHub com cerca de 18,600 stars, resolve essa contradição com um truque antigo: se a coisa não é texto, faça uma representação em texto da coisa. Nesse caso, um script Python paramétrico.

O trabalho do agente não é imaginar um modelo 3D. É escrever código que um kernel de geometria consiga executar. Essa distinção é o produto inteiro.

Como o loop roda de verdade

Por baixo o motor é o cadgen, um pacote Python no PyPI construído sobre build123d, que por sua vez dirige o Open CASCADE, a mesma família de kernels de geometria que ferramentas de CAD sérias usam. Um modelo é um script Python comum: uma função decorada com uma definição step que devolve uma forma.

Digamos que você quer um suporte de câmera com paredes de 3mm e dois furos M3. Você descreve em palavras. O agente escreve o script com parâmetros de espessura de parede, diâmetro do furo e distância entre furos. O cadgen roda e escreve STEP, mais STL, 3MF ou GLB se você pedir. Quer mudar a posição de um furo? Edita um número, roda de novo. O código-fonte do modelo fica no repositório junto do seu outro código, ou seja, dá para diffar, revisar e reverter como qualquer outra coisa.

Essa é a diferença entre geometria exata e uma malha plausível. Um gerador de malha produz uma superfície que parece um suporte. Um modelador de sólidos produz um suporte com espessura de parede conhecida, e uma oficina aceita um arquivo STEP enquanto recusa com educação o seu STL de uma superfície curva com 4,000 triângulos.

O plugin também cuida das partes chatas que decidem se um projeto é real. Roda checagens de design para manufatura e para manufatura aditiva, espessura de parede, balanços, ângulos de saída, reentrâncias, e reporta a regra por trás de cada achado em vez de um aviso seco. Gera desenhos técnicos cotados em PDF com vistas, linhas ocultas, chamadas de furos e carimbo. Escreve perfis DXF para corte a laser, fatia G-code pelo OrcaSlicer, manda impressões para máquinas Bambu Lab, roda checagens de pré-upload para o SendCutSend e escreve arquivos URDF, SRDF e SDF para descrições de robôs e mundos de simulador.

Tem um visualizador local também. Nos apps que suportam, o modelo aparece como card no chat; no resto, você recebe um link de localhost.

Por que isso generaliza

O caso de CAD é específico, o padrão não é. Qualquer domínio que tenha duas propriedades pode ser entregue a um agente de código: uma representação em código do artefato, e um verificador que diz se o artefato é válido.

Peças mecânicas têm as duas. O script é a representação; a checagem de manufaturabilidade é o validador. Páginas web têm as duas, HTML e um navegador. Infraestrutura tem as duas, configuração e um plan. Vídeo, até pouco tempo, não tinha nenhuma das duas numa forma que um agente pudesse executar, e é exatamente essa lacuna que projetos como o HyperFrames estão preenchendo.

Onde falta o verificador, agentes produzem lixo com confiança. É por isso que "AI for 3D" travou nas previews: não havia validador entre "parece uma cadeira" e "dá para fabricar".

A outra metade do padrão é execução local. O cadgen roda na sua máquina, contra um kernel de geometria de verdade. Na etapa de geometria não tem nada sendo aproximado por rede neural. O agente entrega a intenção paramétrica; o kernel entrega a verdade.

Os impostos de adoção, que são reais

Duas coisas vão morder, e as duas estão documentadas no repositório em vez de descobertas na dor, o que é um mérito dos autores.

O Windows 11 tem uma armadilha só dele. O binding Python do kernel de CAD vem com um módulo nativo não assinado, e o Smart App Control do Windows 11, ligado por padrão em instalações novas, bloqueia. Aí todo comando falha com erro de carregamento de DLL. Não existe exceção por aplicativo. Suas opções são desligar o Smart App Control, o que em alguns sistemas só volta reinstalando o Windows, ou rodar as skills de CAD no WSL. Tem um comando doctor que detecta o caso, então pelo menos você descobre rápido.

A telemetria vem ligada por padrão. O README documenta isso com um detalhe incomum, e o instinto está certo. O que vai: versões, origem da instalação, sistema operacional, qual app de agente você usa, e contagens como quantas vezes cada ferramenta foi chamada e quantos modelos foram construídos, mais motivos de falha escolhidos de uma lista fixa em vez do texto do erro. Relatórios de crash incluem o tipo de erro e onde no código quebrou. Tudo leva um ID de instalação aleatório e fica no PostHog; o servidor deduz o país pelo IP e não guarda o endereço. O que nunca vai: nomes de arquivo, caminhos, conteúdo de arquivos, prompts. Dá para desligar com um comando, que também apaga o que já foi enviado, e nada é enviado em CI nem de uma instalação de desenvolvimento.

As duas coisas são normais num projeto jovem e as duas custam adoção. Um fornecedor comercial de CAD não lançaria nenhuma delas.

Para que não serve

Formas orgânicas. Personagens, bonequinhos, formas esculpidas, tudo em que a forma é o ponto e não a função: esse é território de malha, e um modelo image-to-3D baseado em malha é a ferramenta melhor. Tentar descrever um dragão em parâmetros é uma tarde ruim.

Também não substitui o aval de um engenheiro. A skill de DFM é uma revisão guiada, não uma certificação. Se uma peça vai segurar o peso de uma pessoa, um engenheiro humano ainda assina o desenho. O loop termina com alguém pagando uma nota fiscal, e provavelmente é ali que o humano deve ficar.

O repositório em si é jovem e rápido: criado em abril de 2026, mais de 1,400 commits, um pacote no PyPI com dezenas de releases, e três versões publicadas em dois dias no começo de outubro. Esse ritmo é uma vantagem se você gosta de skills novas e um risco se você precisa de estabilidade.

A frase no README que importa

Enterrada na descrição tem uma afirmação fácil de pular: o plugin dá ao seu agente um fluxo de trabalho de CAD de verdade. Não uma demo, não um wrapper de prompt, um fluxo com representação, executor, validador e entrega para um fabricante.

Essa é a forma de coisa que torna agentes úteis fora do software. Não um modelo que entende de suportes, mas um loop em que o modelo escreve algo executável, outra coisa confere, e a saída é um arquivo que outro sistema aceita. O agente não precisa ser bom em CAD. Precisa ser bom em código, e o domínio precisa ter um compilador.

A engenharia mecânica chegou primeiro porque o compilador tem cinquenta anos e o validador é um conjunto de regras de manufatura. Qualquer outro domínio que consiga essas duas peças vai se parecer com isso dentro de um ano.