text-to-cad
让 AI 编程智能体用 Python CAD 设计零件,并把机器人导出到 MuJoCo
许可证
MIT
代码和 skills:MIT,依据 earthtojake/text-to-cad 的 LICENSE 文件以及每个 skill 文件夹中的 LICENSE 文件(版权归 Thompson Labs LLC)。智能体应用:text-to-cad 需要一个单独的 AI 智能体应用,适用其自身条款。服务:SendCutSend 和拓竹(Bambu Lab)是第三方服务,适用其自身条款;skills 只检查和准备文件,不会下单。遥测:除非关闭,使用计数和崩溃报告会发送到 api.texttocad.dev;不会发送模型、提示词和文件路径。卡片图片:裁剪自项目自己的社交预览图,不在代码许可范围内。于 2026-11-13 对照 LICENSE 文件、README 和隐私政策核对。
概述
text-to-cad 是一个开源插件,让 Claude Code、Codex、Cursor 和 Gemini CLI 等 AI 编程智能体设计实体零件和装配体。智能体把每个模型写成 Python 脚本,使用基于 OpenCASCADE 内核的 build123d 库,运行脚本,并在本地 CAD 查看器中显示结果。模型可导出为 STEP、STL、3MF、GLB 或 DXF 文件。其他 skills 检查零件能否进行机加工、切割折弯、注塑或 3D 打印,用 CalculiX 做强度校核,绘制带尺寸标注的 PDF 图纸,用 Blender 渲染图像,用 KiCad 设计电路板,用 OrcaSlicer 切片打印件,并按 SendCutSend 的下单指南检查文件。在机器人方面,它根据模型的关节和材料写出 URDF、SRDF 和 MJCF 机器人描述;自 2026年11月的 0.11.8 版起支持 MuJoCo 4:质量和惯量来自 CAD,一项检查在 MuJoCo 中编译模型,机器人和场景用 Python 组合。项目作者为 earthtojake,采用 MIT 许可,全部在用户自己的电脑上运行。
text-to-cad 是一组智能体 skills,加上一个由编程智能体通过 MCP 调用的本地 CAD 服务器。它的安装脚本会在找到的每个智能体应用中完成配置:Claude Code、Claude Desktop、Codex、Cursor、Grok Build 和 Gemini CLI 获得插件,另外约十五个智能体(包括 GitHub Copilot、Windsurf、Cline 和 Zed)只获得 skills。工具本身是 Python 包 cad,通过 uv 运行。项目网站是 texttocad.dev。
模型是用 build123d 在 OpenCASCADE 内核上编写的 Python 脚本;CAD skill 让智能体运行它、在 CAD 查看器中显示,并导出为 STEP、STL、3MF 或 GLB,或导出用于激光和水刀切割的 DXF 轮廓与展开图。装配体可以带有关节和动画。其他 skills 涵盖机加工、钣金、注塑和 3D 打印的可制造性检查,线性静力强度校核(使用 CalculiX 的有限元法),PDF 工程图,用 Blender 渲染,KiCad 电路板,用 OrcaSlicer 切片并发送到拓竹(Bambu Lab)打印机,以及针对 SendCutSend 订单的预检。
机器人仿真 skill 把模型的关节、材料和命名坐标系转换为供 ROS 2 使用的 URDF、供 MoveIt 使用的 SRDF 和供 MuJoCo 使用的 MJCF。2026年11月11日发布的 0.11.8 版 加入了对 MuJoCo 4.0.0 的支持:
- 每个连杆的质量、质心和惯量通过 CAD 内核由零件材料算出,一条命令即可把机器人导出为 MJCF 或 URDF。 - 一个普通的 Python 函数在 MuJoCo 自己的 spec 上做出仿真选择:拟合为基本体的碰撞形状,或用 CoACD 切分为凸包(凸分解),以及关节阻尼、执行器和传感器。 - cad mujoco check 命令用 MuJoCo 编译文件,并报告静止时相互穿透的零件、错误的尺度、超出范围的关节以及哪些物体会相互碰撞。 - 场景用 Python 组合,例如把在 CAD 中设计的夹爪装到来自别处的机械臂上,再放一个待抓取的方块,并可在浏览器中的 MuJoCo Studio 打开。 - ranges 命令通过转动每个关节直到其零件相碰,找出关节的限位。
MuJoCo 示例项目用制造商的 STEP 文件,把 SO-101 机械臂和 Trossen WidowX AI 走完这一流程,并与 MuJoCo Menagerie 中手工制作的模型比较:总质量相差 1.3% 和 2.7%。项目称它们为示例,而不是基准测试。
为何重要
大多数机器人从 CAD 中的零件开始,而从这些零件得到仿真模型,通常需要商业 CAD 软件和一个单独的转换器,例如 onshape-to-robot。text-to-cad 把整条链路都保持为 AI 智能体编写、人也能读懂的代码:零件、装配体、关节、质量和 MuJoCo 模型都来自同一组 Python 脚本,因此一次设计修改就是一次编辑加一次重新运行。它的 MuJoCo 功能在真实机器人 SO-101 和 WidowX AI 上做过验证,而不是玩具示例。与 SolidCraft 一样,它首先是通用 CAD:机器人功能只是八个 skills 之一,主要对已经在用编程智能体的人有用。
解决的问题
设计一个机器人零件并仿真它所属的机器人,通常需要 CAD 软件、手工核对质量和惯量,以及一个每次修改后都要重新运行的 URDF 或 MJCF 转换器。text-to-cad 让 AI 智能体把零件写成 Python 脚本,检查其可制造性,并从同一组脚本生成机器人描述和 MuJoCo 场景,物理属性直接取自 CAD。
要点
- 插件和 skills,让 AI 编程智能体把零件和装配体写成 build123d 的 Python 脚本
- 导出 STEP、STL、3MF、GLB 和 DXF,并可检查机加工、钣金、注塑和 3D 打印的可制造性
- 根据模型的关节和材料写出 URDF、SRDF 和 MJCF,质量和惯量来自 CAD
- 自 0.11.8 版起支持 MuJoCo 4:MuJoCo 函数、模型检查以及用 Python 组合的场景
- 还能用 CalculiX 做强度校核,生成 PDF 图纸、Blender 渲染和 KiCad 电路板
- MIT 许可;本地运行,无需账号,默认发送使用统计,可以关闭
适用人群
- 已经在用 AI 编程智能体、希望让它设计打印件或机加工零件的机器人制作者
- 手头有机器人 CAD、需要其 MuJoCo 或 URDF 模型的研究人员
- 希望在下单前检查零件能否 3D 打印或做钣金的创客
- 把硬件设计作为代码放在版本控制中的开发者
局限
- 需要 Claude Code、Codex 或 Cursor 等 AI 智能体应用;这些是独立产品,有各自的条款和费用
- 首先是通用 CAD:机器人功能只是八个 skills 之一,MuJoCo 支持到 2026年11月才加入
- 普通的 MJCF 导出不含执行器、关节动力学或选定的碰撞形状;这些要在 MuJoCo 函数中手写
- MuJoCo 示例不是基准测试:执行器增益是为让机器人保持姿态而选的,并非实测
- 用于查看场景的 MuJoCo Studio 在所有网络接口上监听,且没有身份验证
- CoACD 凸分解在 Intel Mac、ARM 版 Windows 和 musl Linux 上不可用
- 强度校核只涵盖线性静载荷
- 安装需要把脚本通过管道交给 shell 执行,并下载约 240 MB 的 CAD 内核
- 默认发送使用统计和崩溃报告;可以关闭
- 主要由一位维护者开发,几天就发布一个新版本