text-to-cad con agente de IA: CAD, instalación y límites

text-to-cad con agente de IA: modelos STEP, STL y 3MF desde Claude Code o Codex. Instalación según el README, telemetría que desactivar y límites.
text-to-cad : CAO par agent IA, installation et limites

text-to-cad con agente de IA: el repositorio earthtojake/text-to-cad es un plugin que da a un agente de código flujos de trabajo locales para producir modelos 3D (STEP, GLB, STL o 3MF), comprobar su fabricabilidad, generar planos acotados y preparar el envío a servicios de impresión 3D, de chapa o de mecanizado. Tenía unas 22 400 estrellas y 2200 forks a mediados de octubre de 2026, con licencia MIT.

Para los ingenieros se plantean dos preguntas: ¿qué se recibe realmente (un archivo de CAD aprovechable o una demostración?) y qué hace este plugin en la máquina, incluida la red? Este artículo sigue el README: instalación, competencias incluidas, telemetría, límites. Propone también algunas pistas para monitorizar el uso de una herramienta así en un equipo.

La información procede del README y de la estructura de carpetas del repositorio. span.observer no ha instalado text-to-cad: la primera imagen es la imagen de presentación publicada en el repositorio, las demás son extractos reales del README, renderizados para facilitar la lectura.

text-to-cad con agente de IA: qué dice el repositorio

  • Editor y licencia: repositorio del usuario de GitHub earthtojake; el archivo LICENSE es MIT, copyright 2026 «Thompson Labs LLC».
  • Versión: el archivo VERSION del repositorio indica 0.7.26, y el README remite al paquete de Python cadgen en PyPI. La página de GitHub no mostraba ninguna release en la fecha de la consulta.
  • Técnica (badges del README): Python 3.11 o más reciente, Node.js 20 o más reciente, build123d 0.11 y Open CASCADE 7.9. El núcleo de CAD se ejecuta localmente mediante uv.
  • Herramientas soportadas: el README cita Claude Code, Claude Desktop, Codex, Cursor, Grok Build, Gemini, así como cualquier agente compatible con el formato de skills (npx skills add).
Imagen de presentación del repositorio text-to-cad: un visor de CAD que muestra en perspectiva un ensamblaje de tren epicicloidal en colores, archivo planetary_gear_assembly.step
Source : github.com

La imagen, publicada en el repositorio (apps/docs/public/social-preview.png), muestra el visor de CAD del proyecto con un ensamblaje de tren planetario. El README explica que, en las herramientas que saben mostrar vistas de aplicación, los modelos aparecen como tarjetas orbitables en la conversación; si no, el agente devuelve un enlace que abre el modelo en el «CAD Viewer» del navegador.

Instalar text-to-cad según el README

Requisitos previos

El CAD pasa por uv: comprueba uv --version, instálalo si falta y reinicia la aplicación del agente. Según el README, el primer arranque descarga el runtime de CAD y por tanto requiere conexión de red.

Paso 1: Claude Code

claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojake

El plugin arranca también el servidor de CAD (cadgen mcp). La rama latest contiene solo el plugin, publicado una vez que la versión está en PyPI; main puede contener cambios no publicados.

Paso 2: las demás herramientas

Para Codex, Cursor, Grok Build o Gemini, el README da un comando por herramienta (por ejemplo gemini extensions install https://github.com/earthtojake/text-to-cad --ref latest --consent --auto-update). Para un agente sin plugin, instala solo las skills:

npx skills add earthtojake/text-to-cad#latest

El README insiste: instala el plugin o las skills en una aplicación, no ambos, porque si no cada skill aparece duplicada.

Paso 3: desactivar la telemetría antes de empezar

uvx cadgen telemetry off
Comandos del README de text-to-cad: adición del marketplace e instalación del plugin en Claude Code, y después desactivación de la telemetría con uvx cadgen telemetry off

Las competencias incluidas

La tabla «Skills» del README enumera doce competencias. En resumen: cad (modelos, con STEP como salida principal y exportaciones STL, 3MF y GLB), step-parts (piezas comerciales), engineering-drawing (planos acotados en PDF), dxf (dibujos 2D), urdf, srdf y sdf (robótica y simulación), controles previos al envío a SendCutSend, dfam-check y dfm (fabricabilidad), gcode (laminado con OrcaSlicer) y bambu-labs (envío a impresoras Bambu Lab).

Resumen de la tabla de competencias del README de text-to-cad: cad, step-parts, engineering-drawing, dxf, urdf, srdf, sdf, sendcutsend, dfam-check, dfm, gcode y bambu-labs

Para comparar con otro enfoque de código abierto del CAD, consulta CADCraft, CAD de código abierto en Rust. Los dos proyectos no tienen la misma ambición: text-to-cad es un conjunto de competencias controlado por un agente, no una aplicación de escritorio.

Monitorizar un agente que hace CAD

Un plugin de CAD local no publica trazas de OpenTelemetry: el README no documenta ninguna. Lo que sí documenta el repositorio es su telemetría de producto y varias variables de control. Para el resto, la monitorización se hace a nivel del agente: consulta la observación de agentes MCP, ya que el servidor cadgen mcp es un servidor MCP local.

Qué envía la telemetría, según el README

  • Por defecto: estadísticas de uso e informes de fallos, etiquetados con un identificador de instalación aleatorio (versiones, sistema, aplicación del agente, número de llamadas a herramientas, duraciones, formatos de archivo mostrados). El README afirma que nunca incluye nombres de archivo, rutas, contenidos ni prompts.
  • Se almacena en PostHog, con el país deducido de la dirección IP, que el servidor no conserva.
  • Desactivación: uvx cadgen telemetry off (que también borra lo que se haya enviado, según el README), el menú «Share usage stats» del visor, o las variables DO_NOT_TRACK=1 y CADGEN_TELEMETRY=0 para un solo proceso. Por defecto no se envía nada en integración continua.
  • Una comprobación de actualización llama a api.texttocad.dev/v1/versions como máximo una vez al día; CADGEN_UPDATE_CHECK=0 la desactiva.

Para una empresa, estos puntos deben revisarse con las mismas barreras de seguridad que para los demás agentes: lista blanca de red, telemetría desactivada por defecto, versiones fijadas.

Cómo comprobar que funciona

  • El README menciona el comando cadgen doctor, que diagnostica, entre otras cosas, el bloqueo de la biblioteca nativa en Windows 11.
  • Pide al agente un modelo sencillo (una placa con cuatro agujeros) y ábrelo en el CAD Viewer: las cotas deben coincidir con tu petición, medidas en otro programa de CAD.
  • Comprueba con tu cortafuegos o tu proxy qué dominios contacta el plugin tras telemetry off.

Límites y puntos abiertos

  • Windows 11 y Smart App Control. El README explica que el módulo nativo de OpenCascade (OCP) no está firmado: si Smart App Control está activado, cada comando cadgen falla con «DLL load failed while importing OCP». Soluciones del README: desactivarlo (irreversible sin reinstalar Windows) o usar WSL.
  • Una pieza generada no es una pieza validada. Las competencias DfM y DfAM miden criterios sobre una malla; no equivalen a una revisión de ingeniería ni a un cálculo de resistencia. Haz revisar las piezas destinadas a fabricarse o a soportar una carga.
  • Acciones sobre hardware real. Algunas skills envían archivos a servicios de fabricación o a una impresora. Mantén una validación humana antes de cualquier envío o lanzamiento de impresión.
  • Dependencia de la versión. La configuración para Claude Desktop fija una versión de cadgen; en ese caso las actualizaciones son manuales.
  • Proyecto joven. Versión 0.x, mucha atención: las interfaces pueden cambiar.

Buenas prácticas

  • Desactiva la telemetría desde la instalación si tu política lo exige, y revisa la sección «Telemetry» del README.
  • Instala la rama latest, no main, y fija la versión.
  • Trabaja en una carpeta de proyecto dedicada; limita los permisos del agente como en la guía del servidor MCP de GitHub.
  • Exige una revisión humana de las cotas y las tolerancias antes de fabricar.

Preguntas frecuentes

¿text-to-cad funciona sin conexión?

Según el README, sin conexión no se envía nada y todo funciona, pero el primer arranque descarga el runtime de CAD y requiere conexión.

¿Qué formatos de archivo produce?

STEP como salida principal, con exportaciones STL, 3MF y GLB, además de dibujos DXF y planos PDF según las competencias.

¿Es gratuito?

El código tiene licencia MIT y el proyecto se presenta como gratuito. Las llamadas al modelo de tu agente las factura tu proveedor.

Conclusión

text-to-cad extiende el principio de las skills de agente al CAD y a la fabricación. La idea es sólida sobre el papel, pero el proyecto es joven (versión 0.7.x) y afecta a objetos físicos: revisión humana, telemetría controlada y versiones fijadas son los tres reflejos que conviene mantener.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en la documentación oficial (texttocad.dev).

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
wshobson agents marketplace : plugins pour agents de code

Marketplace wshobson agents: plugins para agentes de código

Next Post
ppt-master générer PowerPoint agent IA : guide et limites

ppt-master generar PowerPoint con agente de IA: guía y límites

Related Posts