text-to-cad
Faz agentes de IA projetarem peças em CAD com Python e exportarem robôs para o MuJoCo
Licença
MIT
Código e skills: MIT, lido no arquivo LICENSE de earthtojake/text-to-cad e no arquivo LICENSE de cada pasta de skill (copyright Thompson Labs LLC). Apps de agentes: o text-to-cad precisa de um app de agente de IA à parte, com termos próprios. Serviços: SendCutSend e Bambu Lab são serviços de terceiros com termos próprios; as skills verificam e preparam arquivos e não fazem pedidos. Telemetria: contagens de uso e relatórios de falhas vão para api.texttocad.dev a menos que sejam desativados; modelos, prompts e caminhos de arquivos não são enviados. Imagem do card: um recorte da imagem de prévia para redes sociais do próprio projeto, não coberta pela licença do código. Verificado em 2026-11-13 com os arquivos LICENSE, o README e a política de privacidade.
Visão geral
text-to-cad é um plugin de código aberto que permite a agentes de programação com IA como Claude Code, Codex, Cursor e Gemini CLI projetar peças e montagens físicas. O agente escreve cada modelo como um script Python com a biblioteca build123d sobre o kernel OpenCASCADE, executa-o e mostra o resultado em um visualizador CAD local. Os modelos são exportados como arquivos STEP, STL, 3MF, GLB ou DXF. Outras skills verificam se uma peça pode ser usinada, cortada e dobrada, moldada ou impressa em 3D, fazem análises de tensão com o CalculiX, desenham folhas cotadas em PDF, renderizam imagens com o Blender, projetam placas de circuito no KiCad, fatiam impressões com o OrcaSlicer e conferem arquivos pelo guia de pedidos da SendCutSend. Para robótica, ele escreve descrições de robôs em URDF, SRDF e MJCF a partir das juntas e dos materiais de um modelo, e desde a versão 0.11.8 de novembro de 2026 suporta o MuJoCo 4: massas e inércias vêm do CAD, uma verificação compila o modelo no MuJoCo, e robôs e cenas são compostos em Python. O projeto é de earthtojake, sob a licença MIT, e tudo roda no próprio computador do usuário.
O text-to-cad é um conjunto de skills para agentes mais um servidor CAD local que um agente de programação chama via MCP. Seu script de instalação o configura em cada app de agentes que encontra: Claude Code, Claude Desktop, Codex, Cursor, Grok Build e Gemini CLI recebem o plugin, e cerca de quinze outros agentes, entre eles GitHub Copilot, Windsurf, Cline e Zed, só as skills. A ferramenta em si é o pacote Python cad, executado pelo uv. O site do projeto é texttocad.dev.
Um modelo é um script Python escrito com build123d sobre o kernel OpenCASCADE; a skill de CAD faz o agente executá-lo, mostrá-lo no visualizador CAD e exportá-lo em STEP, STL, 3MF ou GLB, ou como perfis DXF e planificações para corte a laser e a jato de água. As montagens podem ter juntas e animações. As outras skills cobrem verificações de fabricação para usinagem, chapa metálica, moldagem e impressão 3D, análises estáticas lineares de tensão (método dos elementos finitos com o CalculiX), desenhos técnicos em PDF, renderizações com o Blender, placas de circuito no KiCad, fatiamento com o OrcaSlicer e envio para impressoras Bambu Lab, e uma verificação prévia para pedidos na SendCutSend.
A skill de simulação de robôs transforma as juntas, os materiais e os sistemas de coordenadas nomeados de um modelo em um URDF para o ROS 2, um SRDF para o MoveIt e um MJCF para o MuJoCo. A versão 0.11.8, de 11 de novembro de 2026, trouxe suporte ao MuJoCo 4.0.0:
- A massa, o centro de massa e a inércia de cada elo vêm dos materiais das peças pelo kernel CAD, e um único comando exporta o robô como MJCF ou URDF. - Uma função Python simples faz as escolhas de simulação sobre a especificação do próprio MuJoCo: formas de colisão ajustadas como primitivas ou divididas em envoltórias convexas com o CoACD (decomposição convexa), amortecimento das juntas, atuadores e sensores. - O comando cad mujoco check compila o arquivo com o MuJoCo e aponta peças que se interpenetram em repouso, escalas erradas, juntas fora da faixa e o que colide com o quê. - As cenas são compostas em Python, por exemplo uma garra projetada em CAD montada em um braço de outra origem com um bloco para pegar, e abrem no MuJoCo Studio no navegador. - Um comando ranges encontra os batentes de cada junta movendo-a até que suas peças se toquem.
Os projetos de exemplo do MuJoCo levam os arquivos STEP do fabricante do braço SO-101 e do Trossen WidowX AI por esse processo e comparam o resultado com os modelos feitos à mão do MuJoCo Menagerie: a massa total fica a 1,3% e 2,7% deles. O projeto os chama de exemplos, não de benchmark.
Por que importa
A maioria dos robôs começa como peças em CAD, e ir dessas peças a um modelo de simulação costuma exigir um programa CAD comercial e um conversor à parte como o onshape-to-robot. O text-to-cad mantém a cadeia inteira como código que um agente de IA escreve e uma pessoa consegue ler: a peça, a montagem, as juntas, as massas e o modelo do MuJoCo saem dos mesmos scripts Python, então uma mudança de projeto é uma edição e uma nova execução. Seu trabalho com o MuJoCo é verificado em robôs reais, o SO-101 e o WidowX AI, e não em exemplos de brinquedo. Como o SolidCraft, é antes de tudo CAD geral: a robótica é uma skill entre oito, útil sobretudo para quem já trabalha com um agente de programação.
Problema que resolve
Projetar uma peça de robô e simular o robô a que ela pertence costuma exigir um programa CAD, trabalho manual para acertar massas e inércias e um conversor para URDF ou MJCF que precisa rodar de novo após cada mudança. O text-to-cad deixa um agente de IA escrever as peças como scripts Python, verificar se podem ser fabricadas e gerar as descrições do robô e as cenas do MuJoCo a partir dos mesmos scripts, com as propriedades físicas tiradas do CAD.
Pontos principais
- Plugin e skills com os quais agentes de programação com IA escrevem peças e montagens como scripts Python em build123d
- Exporta STEP, STL, 3MF, GLB e DXF, com verificações para usinagem, chapa metálica, moldagem e impressão 3D
- Escreve URDF, SRDF e MJCF a partir das juntas e materiais de um modelo, com massas e inércias do CAD
- Suporte ao MuJoCo 4 desde a versão 0.11.8: uma função do MuJoCo, uma verificação do modelo e cenas compostas em Python
- Também faz análises de tensão com o CalculiX, desenhos em PDF, renderizações com o Blender e placas no KiCad
- Licença MIT; roda localmente sem conta e envia estatísticas de uso a menos que sejam desativadas
Para quem é
- Construtores de robôs que já usam um agente de programação com IA e querem que ele projete peças impressas ou usinadas
- Pesquisadores que precisam de um modelo MuJoCo ou URDF de um robô cujo CAD têm
- Makers que querem verificar peças para impressão 3D ou chapa metálica antes de encomendá-las
- Desenvolvedores que mantêm projetos de hardware como código em controle de versão
Limitações
- Precisa de um app de agente de IA como Claude Code, Codex ou Cursor; são produtos à parte, com termos e custos próprios
- Antes de tudo CAD geral: a robótica é uma skill entre oito, e o suporte ao MuJoCo só chegou em novembro de 2026
- A exportação MJCF simples não traz atuadores, dinâmica das juntas nem formas de colisão escolhidas; elas são escritas à mão em uma função do MuJoCo
- Os exemplos do MuJoCo não são um benchmark: os ganhos dos atuadores são escolhidos para o robô manter uma pose, não medidos
- O MuJoCo Studio, usado para ver uma cena, escuta em todas as interfaces de rede sem autenticação
- A decomposição convexa com o CoACD não está disponível em Macs Intel, Windows on ARM nem Linux com musl
- As análises de tensão cobrem só cargas estáticas lineares
- A instalação roda um script enviado ao shell por pipe e baixa um kernel CAD de cerca de 240 MB
- Estatísticas de uso e relatórios de falhas são enviados por padrão; dá para desativá-los
- É principalmente obra de um único mantenedor, com versões a cada poucos dias