Desenhar uma peça para impressora 3D sempre exigiu aprender um programa de CAD (desenho técnico no computador). O text-to-cad muda esse caminho: você descreve a peça em palavras para o seu agente de IA, e ele desenha e entrega o arquivo pronto para imprimir.
É um plugin de código aberto, com cerca de 18 mil estrelas no GitHub (repositório earthtojake/text-to-cad). Ele dá ao agente ferramentas de modelagem que rodam no seu próprio computador, confere se a peça dá para fabricar e ainda gera o desenho técnico com as medidas.
Este guia mostra onde ele funciona, como instalar, como escrever um pedido que o agente acerta de primeira, qual formato de arquivo usar em cada caso e os dois cuidados antes de começar: o custo do agente e o envio de estatística de uso.
Em quais agentes funciona
Claude Code, Codex, Cursor, Gemini e Grok, como plugin ou skill (pacote de instruções e ferramentas que o agente carrega).
O plugin é grátis. O agente que você usa pode ser pago: o Claude Code, por exemplo, precisa de assinatura ou de crédito de API. O custo real é o do agente, não o do plugin.
Como instalar
A forma recomendada pelo próprio projeto é pedir ao agente. Cole isto no Claude Code (ou no agente que você usa):
Install text-to-cad from https://github.com/earthtojake/text-to-cad
Ele precisa do uv, um instalador de ferramentas Python. Se o agente avisar que o uv não está instalado, peça: "instala o uv pra mim". O agente cuida do resto.
Como pedir uma peça que dá certo
O plugin não tem tradução própria: quem entende o seu português é o agente. Então vale o mesmo cuidado de qualquer pedido para IA, com um detalhe a mais: peça física precisa de medida.
Pedido vago:
Faz um suporte de celular.
Pedido que funciona:
Desenha um suporte de celular de mesa para um aparelho de 8 mm de espessura. Base de 80 x 60 mm, encosto inclinado a 65 graus, abertura na frente para passar o cabo do carregador. Paredes de 3 mm. Exporta em STL.
O que fez diferença:
- Medidas em milímetros de tudo que encosta em outra coisa (o celular, a mesa, o cabo).
- Ângulo quando a peça tem inclinação.
- Espessura de parede, que define se a peça aguenta peso.
- Formato de saída pedido explicitamente.
Depois peça ao agente para conferir se a peça dá para fabricar e para gerar o desenho técnico. Confira as medidas no desenho antes de mandar imprimir: errar 1 mm num encaixe é o erro mais comum.
Qual arquivo usar
| Formato | Para quê |
|---|---|
| STL | Impressora 3D, o formato mais aceito pelos fatiadores (programas que preparam a impressão) |
| 3MF | Impressora 3D, guarda mais informação que o STL (cor, unidade de medida) |
| STEP | Abrir e editar em programa de CAD profissional |
| GLB | Visualizar o modelo 3D em navegador ou apresentação |
Na dúvida, peça STL para imprimir e STEP para guardar uma versão editável.
O projeto também conecta com serviços de impressão 3D, corte de chapa e CNC (usinagem por máquina), para quem não tem impressora em casa.
Desligar o envio de estatística
Por padrão, o text-to-cad envia estatística de uso e relatório de erro para os autores. Segundo o projeto, não vão arquivos nem os seus pedidos. Se mesmo assim preferir desligar, rode no terminal (ou peça ao agente para rodar):
uvx cadgen telemetry off
Fatos conferidos no README do projeto em 08/10/2026.