Text-to-CAD

给编码智能体加上 CAD 建模能力的开源插件,在本机生成 3D 模型,MIT 许可开源

关于 Text-to-CAD

text-to-cad 是一个给编码智能体加上 CAD 建模能力的开源插件:在本机按文字或图片请求生成 STEP 为主的 3D 模型,可导出 STL、3MF 与 GLB,并提供可制造性检查、工程图,以及对接 3D 打印、钣金与 CNC 加工服务的技能。官方写支持 Claude Code、Codex、Cursor、Gemini 与 Grok,底层运行时 cadgen 基于 build123d。许可证为 MIT,版权方为 Thompson Labs LLC;首页写 100% 开源且免费。

它解决什么问题

GitHub 描述与首页标题的口号是让智能体具备 CAD 能力。首页写 text-to-cad 插件为智能体提供在本机生成 3D 模型的流程,输出 STEP、GLB、STL 或 3MF 文件,同时做可制造性检查、生成工程图,并对接常见的 3D 打印、钣金与 CNC 加工服务。

问题与做法。text-to-cad 不是独立的建模软件,而是装进现有智能体应用的插件与技能集合:智能体按自然语言或图片请求写出模型脚本,由 cadgen 运行时构建并校验模型,再在聊天内的查看器卡片或浏览器中的 CAD Viewer 展示结果。

运行方式。服务条款写处理用户的提示词、模型与文件都在用户自己的电脑上完成,Thompson Labs LLC 不主张对其中任何内容的权利。

发展历程。仓库 2026-04-22 09:09 (UTC+8) 创建。GitHub Releases 中最早的 0.1.16 发布于 2026-05-30 13:40 (UTC+8);最新的 v0.7.26 发布于 2026-10-21 03:07 (UTC+8),此前 v0.7.25 发布于 2026-10-20 15:24 (UTC+8),v0.7.24 发布于 2026-10-19 04:34 (UTC+8)。

出品方:Thompson Labs LLC。服务条款写 text-to-cad 由 Thompson Labs LLC 提供,范围包括插件及其技能、cadgen 软件、step.parts 零件库和 texttocad.dev 网站;LICENSE 版权行为 Copyright (c) 2026 Thompson Labs LLC。

Give your agent CAD superpowers. 100% open source and free.

text-to-cad 首页

核心能力

CAD 建模。CAD 技能按自然语言或图片请求创建和编辑 CAD 模型,以 STEP 为主要输出,可导出 STL、3MF 与 GLB。

零件库。step.parts 技能查找螺丝、轴承、电机、连接器等现成 STEP 零件;step.parts 网站标题写其提供 16,000+ 个开源 STEP 零件(均为官方自述)。

图纸与二维输出。Engineering Drawing 技能从零件生成 PDF 格式的带尺寸工程图,含视图、隐藏线、尺寸、孔标注与标题栏;DXF 技能生成轮廓、模板、垫片、切割排版等二维 DXF 图。

机器人与仿真描述。URDF 技能编写含连杆、关节、限位、惯性参数与网格的机器人结构文件;SRDF 技能为 URDF 添加 MoveIt 规划组、末端执行器、姿态与碰撞规则;SDF 技能生成带坐标系、物理、传感器与灯光的仿真模型和场景。

制造检查与对接。DFM 技能按钣金、CNC 加工或注塑工艺审查零件,每条结论附测量依据与所引规则;DfAM Check 按打印工艺测量壁厚、悬垂、支撑体积与成型方向;SendCutSend 技能在上传前检查 DXF 与 STEP 文件;G-code 技能用 OrcaSlicer 和用户自己的打印机预设切片;Bambu Labs 技能经 Bambu Connect 或 Bambu Studio 把打印任务发到 Bambu Lab 打印机。

运行时。cadgen 的 pyproject.toml 写其依赖 build123d(>=0.11.1,<0.12)与 cadquery-ocp-novtk,要求 Python 3.11 以上。

谁在用

截至 2026-10-26,GitHub API 显示 23,117 个星标、2,246 个 Fork、贡献者账号 20 个;GitHub 接口的 open_issues_count(含未关闭的 issue 与 PR)为 39。

支持的智能体应用。首页写 text-to-cad 支持所有支持插件或 skills 框架的常见智能体,包括 Claude Code、Codex、Cursor、Gemini 与 Grok。README 另给出 Claude Desktop 的 MCP 服务器配置,并写 Codex 可从其插件目录安装。

和同类比

和 Zoo 比:Zoo 的页面写其对话式 CAD 智能体 Zookeeper 内置于 Zoo Design Studio,并写该产品是在其 Text-to-CAD 经验之上开发的;Zoo Design Studio 提供 Mac、Windows、Linux 版本和浏览器试用。text-to-cad 与之同名,出品方为 Thompson Labs LLC,以插件形式装进 Claude Code、Codex 等现有智能体应用,在本机运行。

和 CadQuery 比:CadQuery 是基于 OCCT 的 Python 参数化 CAD 脚本框架,其 LICENSE 开头写依据 Apache Public License v2.0 授权,GitHub 识别为 NOASSERTION。text-to-cad 不直接提供建模库,而是在建模库之上加了智能体技能、查看器与制造检查。

和 build123d 比:build123d 是 Python CAD 编程库,采用 Apache License 2.0;cadgen 的 pyproject.toml 把它列为依赖,text-to-cad 本身为 MIT。

适合与不适合

适合:

  • 已在用 Claude Code、Codex、Cursor、Gemini 或 Grok,需要让智能体直接产出 STEP、STL、3MF 等 CAD 文件的开发者。
  • 做 3D 打印、钣金或 CNC 加工,需要在下单前做可制造性检查和出工程图的个人与小团队。
  • 编写机器人 URDF、SRDF 或仿真 SDF 文件的机器人开发者。
  • 需要模型、提示词与文件留在本机的用户:隐私政策写插件与 cadgen 不把提示词、模型、图纸、文件名和路径发出用户的电脑;让智能体查找零件时,step-parts 技能会把搜索词和所请求的零件发给 step.parts。

不适合:

  • 需要完整图形化 CAD 软件与人工建模界面的场景:text-to-cad 依赖智能体应用驱动建模。
  • 不接受任何使用统计上报的环境:首页写 text-to-cad 默认发送使用统计与崩溃报告,需手动关闭。
  • 需要供应商担保生成结果的场景:服务条款写软件按现状提供,不作任何担保,加工、下单或使用前需自行检查生成的模型、图纸与制造文件。

上手路径

前置条件。README 写 CAD 通过 uv 运行,需先装好 uv;首次启动会下载 CAD 运行时,需要联网。cadgen 要求 Python 3.11 以上,README 徽章另标 Node.js 20+。

安装。首页与 README 列出的推荐方式是把安装请求发给智能体,由智能体自行安装。手动安装时,Claude Code 通过插件市场添加并安装插件;Codex 可从插件目录安装;Cursor 把仓库的 latest 分支克隆到本地插件目录;Gemini 以扩展形式安装;没有插件支持的智能体用 Skills CLI(npx skills add)只装技能。README 写插件与单独技能二选一,同时装会让每个技能出现两次。

Claude Desktop。README 给出在 Claude Desktop 配置文件中添加 MCP 服务器的写法,通过 uvx 运行固定版本的 cadgen mcp,更新时改配置中的版本号。

查看模型。能显示应用视图的智能体应用以聊天内查看器卡片展示模型;终端或只显示文字结果的应用(如 Grok Build、Gemini)给出在浏览器中打开 CAD Viewer 的链接。

定价与许可证

价格:免费。首页写 100% open source and free;隐私政策写不设账号。

许可证:LICENSE 为 MIT,版权行 Copyright (c) 2026 Thompson Labs LLC;GitHub API 识别为 MIT,服务条款写软件以 MIT 许可发布。packages/cadgen 与 apps/web 目录以及 skills 下 12 个技能目录各有一份 LICENSE,均为 MIT,版权方同为 Thompson Labs LLC。PyPI 上 cadgen 的许可表达式为 MIT。

依赖许可:底层 CAD 库 build123d 采用 Apache License 2.0。

风险与局限

默认开启遥测。首页与 README 写 text-to-cad 默认发送使用统计与崩溃报告,附随机 ID,不含文件、路径或提示词,可用 uvx cadgen telemetry off 关闭。隐私政策写遥测在 cadgen 首次提示后开始发送,CI 与开发安装默认不发送;数据由 PostHog 保存,保留期为其套餐的事件保留期,目前为一年;关闭遥测会删除该安装 ID 下存储的全部数据。

联网组件。隐私政策写 cadgen 每天最多一次向 api.texttocad.dev 查询最新版本,可用 CADGEN_UPDATE_CHECK=0 关闭;让智能体查找零件时,step-parts 技能会把搜索词和所请求的零件发给 step.parts;托管方 Vercel 的请求日志含 IP 地址、时间与 user agent,30 天内删除。

Windows 11 兼容。README 写 CAD 内核 OCP 的 wheel 含未签名的原生模块,开启 Smart App Control 的 Windows 11 机器上 cadgen 命令会报 DLL 加载失败;该功能没有按应用的例外,只能关闭它或改在 WSL 下运行。

查看器问题。issue #680 于 2026-10-24 提交,报告 Claude 桌面应用中内联 CAD 查看器打开失败,提示 IPC not available for MCP tool call,截至 2026-10-26 仍为 open。

无担保。服务条款写软件与 step.parts 按现状提供,不作任何担保。

我们的判断

text-to-cad 的特点是:把建模、零件查找、工程图、制造检查与打印对接打包为编码智能体的插件,在本机运行,MIT 许可且免费。

它的限制:遥测默认开启,需要手动关闭;Windows 11 开启 Smart App Control 时无法运行 CAD 内核;生成的模型与制造文件没有担保,加工前需自行检查。

资料来源

官方

  1. text-to-cad | Give your agent CAD superpowerstexttocad.dev · 访问于 2026 年 10 月 26 日
  2. Terms of Service | text-to-cadtexttocad.dev · 访问于 2026 年 10 月 26 日
  3. Privacy Policy | text-to-cadtexttocad.dev · 访问于 2026 年 10 月 26 日
  4. text-to-cad READMEGitHub · 访问于 2026 年 10 月 26 日
  5. text-to-cad LICENSE (MIT)GitHub · 访问于 2026 年 10 月 26 日
  6. cadgen package LICENSE (MIT)GitHub · 访问于 2026 年 10 月 26 日
  7. cadgen pyproject.tomlGitHub · 访问于 2026 年 10 月 26 日
  8. text-to-cad repository on GitHubGitHub · 访问于 2026 年 10 月 26 日

动态与深度阅读