Text-to-CAD: fuente paramétrica, evidencia geométrica y entrega responsable
Configurar Text-to-CAD localmente: dependencias compatibles y directorio correcto
Separa instalación de habilidades, cadgen y navegador, y entiende por qué los enlaces del visor dependen de su directorio de inicio.
Qué aprenderás
- Habilidad y runtime deben coincidir
- Elegir deliberadamente el espacio de modelos
- Comprobar artefactos antes de compartir enlaces
Antes de empezar
- Funciones, módulos y rutas Python básicos
- Unidades y diferencia entre diseño y pieza física
Planificar un ejercicio acotado y distinguir actualidad, inspección, revisión visual y fabricación.
Conclusiones clave
- Alinea el runtime con la versión fijada por la habilidad.
- El directorio actual define la raíz servida.
- Usa la URL devuelta y verifica la ruta del artefacto.
Habilidad y runtime deben coincidir
El README explica instalación de habilidades individuales; sus requirements fijan la distribución cadgen esperada. La guía usa el intérprete activo del proyecto y cadgen doctor comprueba compatibilidad con la habilidad elegida. No supongas que un cadgen global cualquiera coincide con instrucciones recién descargadas.
El visor requiere Python 3.11 o posterior y distribuye servidor y cliente precompilado mediante cadgen sin Node en ejecución. Las capturas necesitan además un navegador instalado por separado. La ausencia de Chromium y la de cadgen son fallos de configuración diferentes.
Elegir deliberadamente el espacio de modelos
El visor sirve el directorio desde el que se inicia, fijado durante toda la vida del proceso. Elige un espacio acotado de modelos, no la raíz con dependencias y archivos ajenos. Lee la URL del JSON devuelto en vez de asumir que el puerto inicial está libre.
El lanzador documentado puede reutilizar una instancia del mismo directorio resuelto e identidad de visor o abrir otra en un puerto disponible. El parámetro file es relativo a la raíz servida por esa instancia. Enlaces relativos iguales en instancias distintas pueden identificar archivos diferentes.
Comprobar artefactos antes de compartir enlaces
Construye primero un modelo generado y confirma que existe su archivo. El visor compila bytes de documentos STEP existentes o importados, pero no ejecuta el generador para crear geometría ausente. Un directorio o ruta inaccesible no sustituye al artefacto pedido.
El ejemplo supone una instalación revisada y que el directorio actual es el espacio de modelos. Usa enlace local en este ejercicio. No instalamos paquetes o navegadores, iniciamos el visor, lo expusimos públicamente ni conectamos equipos de fabricación.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Selecciona intérprete dedicado y revisión revisada.
- 2
Comprueba runtime y navegador.
- 3
Construye o localiza el documento exacto.
- 4
Inicia desde su espacio y lee la URL.
Ejemplo para copiar
cadgen viewer --host 127.0.0.1 --json
cadgen viewer listPreguntas frecuentes
¿El visor necesita Node en ejecución?
La guía indica que cadgen incluye servidor y cliente precompilado sin Node en runtime.
¿Abrir el enlace ejecuta un generador ausente?
No. Muestra documentos existentes; los generados deben construirse antes.
Fuentes
- Text-to-CAD / README.mdFuente verificada 2026-09-14
- Text-to-CAD / skills/cad/SKILL.mdFuente verificada 2026-09-14
- Text-to-CAD / skills/cad-viewer/SKILL.mdFuente verificada 2026-09-14