text-to-cad CAO par agent IA : le dépôt earthtojake/text-to-cad est un plugin qui donne à un agent de code des flux de travail locaux pour produire des modèles 3D (STEP, GLB, STL ou 3MF), contrôler leur fabricabilité, générer des plans cotés et préparer l’envoi vers des services d’impression 3D, de tôlerie ou d’usinage. Il affichait environ 22 400 étoiles et 2 200 forks à la mi-octobre 2026, sous licence MIT.
Pour des ingénieurs, deux questions se posent : que reçoit-on réellement (un fichier de CAO exploitable, ou une démonstration ?) et que fait ce plugin sur la machine, y compris côté réseau ? Cet article suit le README : installation, compétences livrées, télémétrie, limites. Il propose aussi quelques pistes pour superviser l’usage d’un tel outil dans une équipe.
Les informations viennent du README et de l’arborescence du dépôt. span.observer n’a pas installé text-to-cad : la première image est l’image de présentation publiée dans le dépôt, les autres sont des extraits réels du README, rendus pour la lecture.
text-to-cad CAO par agent IA : ce que dit le dépôt
- Éditeur et licence : dépôt de l’utilisateur GitHub
earthtojake; le fichier LICENSE est MIT, copyright 2026 « Thompson Labs LLC ». - Version : le fichier
VERSIONdu dépôt indique 0.7.26, et le README renvoie vers le paquet Pythoncadgensur PyPI. La page GitHub n’affichait aucune release à la date de relecture. - Technique (badges du README) : Python 3.11 ou plus récent, Node.js 20 ou plus récent, build123d 0.11 et Open CASCADE 7.9. Le noyau CAO s’exécute localement via uv.
- Outils pris en charge : le README cite Claude Code, Claude Desktop, Codex, Cursor, Grok Build, Gemini, ainsi que tout agent compatible avec le format de skills (
npx skills add).

L’image, publiée dans le dépôt (apps/docs/public/social-preview.png), montre le visualiseur CAO du projet avec un assemblage de train planétaire. Le README explique que, dans les outils qui savent afficher des vues d’application, les modèles apparaissent comme des cartes orbitables dans la conversation ; sinon, l’agent renvoie un lien qui ouvre le modèle dans le « CAD Viewer » du navigateur.
Installer text-to-cad d’après le README
Prérequis
La CAO passe par uv : vérifiez uv --version, installez-le s’il manque, puis redémarrez l’application de l’agent. Selon le README, le premier démarrage télécharge le runtime de CAO et demande donc une connexion réseau.
Étape 1 — Claude Code
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojake
Le plugin démarre aussi le serveur de CAO (cadgen mcp). La branche latest contient le plugin seul, publié une fois la version sur PyPI ; main peut contenir des changements non publiés.
Étape 2 — Les autres outils
Pour Codex, Cursor, Grok Build ou Gemini, le README donne une commande par outil (par exemple gemini extensions install https://github.com/earthtojake/text-to-cad --ref latest --consent --auto-update). Pour un agent sans plugin, installez seulement les skills :
npx skills add earthtojake/text-to-cad#latest
Le README insiste : installez le plugin ou les skills dans une application, pas les deux, sinon chaque skill apparaît en double.
Étape 3 — Couper la télémétrie avant de commencer
uvx cadgen telemetry off

Les compétences livrées
Le tableau « Skills » du README liste douze compétences. En résumé : cad (modèles, avec STEP comme sortie principale et exports STL, 3MF et GLB), step-parts (pièces du commerce), engineering-drawing (plans cotés en PDF), dxf (dessins 2D), urdf, srdf et sdf (robotique et simulation), des contrôles avant envoi chez SendCutSend, dfam-check et dfm (fabricabilité), gcode (tranchage avec OrcaSlicer) et bambu-labs (envoi vers des imprimantes Bambu Lab).

Pour comparer avec une autre approche open source de la CAO, voir CADCraft, CAO open source en Rust. Les deux projets n’ont pas la même ambition : text-to-cad est un jeu de compétences piloté par un agent, pas une application de bureau.
Superviser un agent qui fait de la CAO
Un plugin de CAO local ne publie pas de traces OpenTelemetry : le README n’en documente pas. Ce que le dépôt documente en revanche, c’est sa télémétrie produit et plusieurs variables de contrôle. Pour le reste, la supervision se fait au niveau de l’agent : voir l’observation des agents MCP, puisque le serveur cadgen mcp est un serveur MCP local.
Ce que la télémétrie envoie, selon le README
- Par défaut : statistiques d’usage et rapports de plantage, étiquetés par un identifiant d’installation aléatoire (versions, système, application d’agent, nombre d’appels d’outils, durées, formats de fichiers affichés). Le README affirme qu’elle n’inclut jamais de noms de fichiers, de chemins, de contenus ni de prompts.
- Elle est stockée chez PostHog, avec le pays déduit de l’adresse IP, que le serveur ne conserve pas.
- Désactivation :
uvx cadgen telemetry off(qui supprime aussi ce qui a été envoyé, d’après le README), le menu « Share usage stats » du visualiseur, ou les variablesDO_NOT_TRACK=1etCADGEN_TELEMETRY=0pour un seul processus. Rien n’est envoyé par défaut en intégration continue. - Une vérification de mise à jour appelle
api.texttocad.dev/v1/versionsau plus une fois par jour ;CADGEN_UPDATE_CHECK=0la coupe.
Pour une entreprise, ces points sont à passer en revue avec les mêmes garde-fous que pour les autres agents : liste blanche réseau, désactivation de la télémétrie par défaut, versions épinglées.
Comment vérifier que ça fonctionne
- Le README mentionne la commande
cadgen doctor, qui diagnostique notamment le blocage de la bibliothèque native sous Windows 11. - Demandez à l’agent un modèle simple (une plaque avec quatre trous) et ouvrez-le dans le CAD Viewer : les cotes doivent correspondre à votre demande, mesurées dans un autre logiciel de CAO.
- Vérifiez avec votre pare-feu ou votre proxy quels domaines le plugin contacte après
telemetry off.
Limites et points ouverts
- Windows 11 et Smart App Control. Le README explique que le module natif d’OpenCascade (OCP) n’est pas signé : si Smart App Control est activé, chaque commande
cadgenéchoue avec « DLL load failed while importing OCP ». Solutions du README : le désactiver (irréversible sans réinstaller Windows) ou utiliser WSL. - Une pièce générée n’est pas une pièce validée. Les compétences DfM et DfAM mesurent des critères sur un maillage ; elles n’équivalent pas à une revue d’ingénierie ni à un calcul de résistance. Faites relire les pièces destinées à être fabriquées ou à porter une charge.
- Actions sur du matériel réel. Des skills envoient des fichiers à des services de fabrication ou à une imprimante. Gardez une validation humaine avant tout envoi ou lancement d’impression.
- Dépendance à la version. La configuration pour Claude Desktop épingle une version de
cadgen; les mises à jour sont manuelles dans ce cas. - Projet jeune. Version 0.x, forte attention : les interfaces peuvent changer.
Bonnes pratiques
- Désactivez la télémétrie dès l’installation si votre politique l’exige, et relisez la section « Telemetry » du README.
- Installez la branche
latest, pasmain, et épinglez la version. - Travaillez dans un dossier de projet dédié ; limitez les droits de l’agent comme dans le guide du serveur MCP GitHub.
- Exigez une revue humaine des cotes et des tolérances avant fabrication.
Questions fréquentes
text-to-cad fonctionne-t-il sans connexion ?
Selon le README, hors ligne rien n’est envoyé et tout fonctionne, mais le premier démarrage télécharge le runtime de CAO et demande une connexion.
Quels formats de fichiers produit-il ?
STEP comme sortie principale, avec des exports STL, 3MF et GLB, ainsi que des dessins DXF et des plans PDF selon les compétences.
Est-ce gratuit ?
Le code est sous licence MIT et le projet se présente comme gratuit. Les appels au modèle de votre agent sont facturés par votre fournisseur.
Conclusion
text-to-cad prolonge le principe des skills d’agent vers la CAO et la fabrication. L’idée est solide sur le papier, mais le projet est jeune (version 0.7.x) et touche à des objets physiques : revue humaine, télémétrie maîtrisée et versions épinglées sont les trois réflexes à garder.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans la documentation officielle (texttocad.dev).