text-to-cad
Des agents IA conçoivent des pièces en CAO Python et exportent les robots vers MuJoCo
Licence
MIT
Code et skills : MIT, lu dans le fichier LICENSE de earthtojake/text-to-cad et dans le fichier LICENSE de chaque dossier de skill (copyright Thompson Labs LLC). Applications d'agent : text-to-cad nécessite une application d'agent IA distincte, avec ses propres conditions. Services : SendCutSend et Bambu Lab sont des services tiers avec leurs propres conditions ; les skills vérifient et préparent des fichiers et ne passent aucune commande. Télémétrie : les comptages d'usage et les rapports de plantage partent vers api.texttocad.dev sauf désactivation ; modèles, prompts et chemins de fichiers ne sont pas envoyés. Image de la carte : un recadrage de l'image d'aperçu pour les réseaux sociaux du projet lui-même, non couverte par la licence du code. Vérifié le 2026-11-13 à partir des fichiers LICENSE, du README et de la politique de confidentialité.
Aperçu
text-to-cad est un plugin open source qui permet à des agents de programmation IA comme Claude Code, Codex, Cursor et Gemini CLI de concevoir des pièces et des assemblages physiques. L'agent écrit chaque modèle sous forme de script Python avec la bibliothèque build123d sur le noyau OpenCASCADE, l'exécute et affiche le résultat dans une visionneuse de CAO locale. Les modèles s'exportent en fichiers STEP, STL, 3MF, GLB ou DXF. D'autres skills vérifient si une pièce peut être usinée, découpée et pliée, moulée ou imprimée en 3D, font des calculs de contraintes avec CalculiX, tracent des plans cotés en PDF, produisent des rendus avec Blender, conçoivent des circuits imprimés KiCad, tranchent les impressions avec OrcaSlicer et contrôlent les fichiers selon le guide de commande de SendCutSend. Pour la robotique, il écrit des descriptions de robots en URDF, SRDF et MJCF à partir des articulations et des matériaux d'un modèle, et depuis la version 0.11.8 de novembre 2026 il prend en charge MuJoCo 4 : masses et inerties viennent de la CAO, une vérification compile le modèle dans MuJoCo, et robots et scènes se composent en Python. Le projet est signé earthtojake, sous licence MIT, et tout tourne sur l'ordinateur de l'utilisateur.
text-to-cad est un ensemble de skills pour agents accompagné d'un serveur de CAO local qu'un agent de programmation appelle via MCP. Son script d'installation l'installe dans chaque application d'agent qu'il trouve : Claude Code, Claude Desktop, Codex, Cursor, Grok Build et Gemini CLI reçoivent le plugin, et une quinzaine d'autres agents, dont GitHub Copilot, Windsurf, Cline et Zed, les skills seules. L'outil lui-même est le paquet Python cad, exécuté via uv. Le site du projet est texttocad.dev.
Un modèle est un script Python écrit avec build123d sur le noyau OpenCASCADE ; la skill de CAO fait que l'agent l'exécute, l'affiche dans la visionneuse et l'exporte en STEP, STL, 3MF ou GLB, ou en profils DXF et développés pour la découpe laser et jet d'eau. Les assemblages peuvent porter des articulations et des animations. Les autres skills couvrent les vérifications de fabrication pour l'usinage, la tôlerie, le moulage et l'impression 3D, les calculs statiques linéaires de contraintes (méthode des éléments finis avec CalculiX), les plans techniques en PDF, les rendus avec Blender, les circuits imprimés KiCad, le tranchage avec OrcaSlicer et l'envoi vers les imprimantes Bambu Lab, et un contrôle préalable des commandes SendCutSend.
La skill de simulation de robots transforme les articulations, les matériaux et les repères nommés d'un modèle en URDF pour ROS 2, en SRDF pour MoveIt et en MJCF pour MuJoCo. La version 0.11.8, du 11 novembre 2026, a ajouté la prise en charge de MuJoCo 4.0.0 :
- La masse, le centre de masse et l'inertie de chaque segment viennent des matériaux des pièces via le noyau de CAO, et une seule commande exporte le robot en MJCF ou en URDF. - Une simple fonction Python fait les choix de simulation sur la spécification propre à MuJoCo : formes de collision ajustées en primitives ou découpées en enveloppes convexes avec CoACD (décomposition convexe), amortissement des articulations, actionneurs et capteurs. - La commande cad mujoco check compile le fichier avec MuJoCo et signale les pièces qui s'interpénètrent au repos, les échelles erronées, les articulations hors de leur plage et ce qui entre en collision avec quoi. - Les scènes se composent en Python, par exemple une pince conçue en CAO montée sur un bras venu d'ailleurs avec un bloc à saisir, et s'ouvrent dans MuJoCo Studio dans le navigateur. - Une commande ranges trouve les butées de chaque articulation en la déplaçant jusqu'à ce que ses pièces se touchent.
Les projets d'exemple MuJoCo font passer par ce processus les fichiers STEP du fabricant du bras SO-101 et du Trossen WidowX AI et comparent le résultat aux modèles faits à la main de MuJoCo Menagerie : la masse totale s'en écarte de 1,3 % et 2,7 %. Le projet les présente comme des exemples, pas comme un benchmark.
Pourquoi c'est important
La plupart des robots commencent comme des pièces en CAO, et passer de ces pièces à un modèle de simulation demande en général un logiciel de CAO commercial et un convertisseur séparé comme onshape-to-robot. text-to-cad garde toute la chaîne sous forme de code qu'un agent IA écrit et qu'une personne peut lire : la pièce, l'assemblage, les articulations, les masses et le modèle MuJoCo sortent des mêmes scripts Python, si bien qu'une modification de conception tient en une édition et une nouvelle exécution. Son travail sur MuJoCo est vérifié sur de vrais robots, le SO-101 et le WidowX AI, plutôt que sur des exemples jouets. Comme SolidCraft, c'est d'abord de la CAO générale : la robotique est une skill sur huit, utile surtout à qui travaille déjà avec un agent de programmation.
Le problème résolu
Concevoir une pièce de robot et simuler le robot auquel elle appartient demande en général un logiciel de CAO, du travail manuel pour obtenir les bonnes masses et inerties, et un convertisseur vers URDF ou MJCF à relancer après chaque modification. text-to-cad permet à un agent IA d'écrire les pièces en scripts Python, de vérifier qu'elles sont fabricables et de générer les descriptions du robot et les scènes MuJoCo à partir des mêmes scripts, avec les propriétés physiques issues de la CAO.
Points clés
- Plugin et skills qui permettent à des agents de programmation IA d'écrire pièces et assemblages en scripts Python build123d
- Exporte STEP, STL, 3MF, GLB et DXF, avec des vérifications pour l'usinage, la tôlerie, le moulage et l'impression 3D
- Écrit URDF, SRDF et MJCF à partir des articulations et des matériaux d'un modèle, avec masses et inerties issues de la CAO
- Prise en charge de MuJoCo 4 depuis la version 0.11.8 : une fonction MuJoCo, une vérification du modèle et des scènes composées en Python
- Fait aussi des calculs de contraintes avec CalculiX, des plans PDF, des rendus Blender et des circuits KiCad
- Licence MIT ; tourne en local sans compte et envoie des statistiques d'usage sauf désactivation
Pour qui
- Constructeurs de robots qui utilisent déjà un agent de programmation IA et veulent lui faire concevoir des pièces imprimées ou usinées
- Chercheurs qui ont besoin d'un modèle MuJoCo ou URDF d'un robot dont ils ont la CAO
- Makers qui veulent faire vérifier des pièces pour l'impression 3D ou la tôlerie avant de commander
- Développeurs qui gardent leurs conceptions matérielles sous forme de code en gestion de versions
Limites
- Il faut une application d'agent IA comme Claude Code, Codex ou Cursor ; ce sont des produits distincts avec leurs propres conditions et coûts
- D'abord de la CAO générale : la robotique est une skill sur huit, et la prise en charge de MuJoCo n'est arrivée qu'en novembre 2026
- L'export MJCF simple ne contient ni actionneurs, ni dynamique des articulations, ni formes de collision choisies ; on les écrit à la main dans une fonction MuJoCo
- Les exemples MuJoCo ne sont pas un benchmark : les gains de leurs actionneurs sont choisis pour que le robot tienne une pose, pas mesurés
- MuJoCo Studio, qui sert à voir une scène, écoute sur toutes les interfaces réseau sans authentification
- La décomposition convexe avec CoACD n'est pas disponible sur les Mac Intel, Windows on ARM ni Linux musl
- Les calculs de contraintes ne couvrent que les charges statiques linéaires
- L'installation exécute un script envoyé au shell par un pipe et télécharge un noyau de CAO d'environ 240 Mo
- Les statistiques d'usage et les rapports de plantage sont envoyés par défaut ; on peut les désactiver
- Surtout l'œuvre d'un seul mainteneur, avec des versions tous les quelques jours