text-to-cad 是什么:让 Agent 做 CAD 零件

text-to-cad 给编程 Agent 一套本地 CAD 工作流:用自然语言或图片描述零件与装配,Agent 写出基于 build123d(Open CASCADE)的 Python,再由本机 cad-server 编成 STEP / GLB / STL / 3MF,并在 Agent 内或浏览器里跟着重建预览。截至 2026-11-06,仓库 MIT,GitHub 25,646 星;配套 PyPI 包 cad-server 为 0.10.4(与仓库 tag 同日)。
它是什么
作者 Jake(earthtojake / Thompson Labs)维护的开源项目。流程固定三步:Agent 写模型脚本 → 本机服务器把改动编成 .xbf 文档并导出声明的格式 → CAD Viewer 跟随每次重建。除建模外,还有面向制造的检查、工程图,以及对 3D 打印 / 钣金 / CNC 服务的衔接 Skill。官网 texttocad.dev。
| 仓库 | github.com/earthtojake/text-to-cad |
|---|---|
| 作者 | Jake / Thompson Labs LLC(earthtojake) |
| 许可证 | MIT |
| 热度 | GitHub 25,646 星(GitHub API,2026-11-06 14:10 北京时间) |
| 语言 / 运行要求 | Python;核心几何走 build123d / Open CASCADE。PyPI cad-server 标明 requires-python >= 3.14。需本机可写的 Agent 环境。 |
| 最新版本 | v0.10.4(GitHub Release 与 cad-server 0.10.4,2026-11-06 10:53 北京时间);说明含导出公差与依赖更新。 |
解决什么问题
产品与机器人原型阶段,常要在「对话里改尺寸」和「真正能拿去打印/机加的 STEP」之间来回。text-to-cad 把建模落成可版本管理的 Python 脚本,导出工业常见格式,并用 Skill 补工程图、可打印性(壁厚、悬垂)、钣金/CNC/注塑 DFM 规则,以及 URDF 等机器人描述。
模型以脚本为源,不是一次性聊天网格:改参数后服务器只重建变动部分,Viewer 跟着刷新。需要标准件时走 step-parts;外发钣金或打印前可先跑 DFM / DfAM 检查,少走「画完才发现打不了」的弯路。适合迭代零件与简单装配;复杂自由曲面和正式 PLM 仍要专业 CAD。
怎么用
# macOS / Linux
curl -fsSL https://texttocad.dev/install.sh | sh
# Windows PowerShell
irm https://www.texttocad.dev/install.ps1 | iex
# 装好后直接向 Agent 要零件或装配;更新可再跑安装脚本或点 CAD 更新按钮
# 手装与分应用说明见仓库 docs/install.md
安装脚本会按本机已装的 Agent 写入插件或 Skill,并升级 CAD 服务。分应用手装与迁移说明在 docs/install.md。Skill 一览(均在仓库 skills/):
cad:自然语言/图片 → Python 模型 → XBF + STEP/STL/3MF/GLBengineering-drawing:带尺寸的工程图 PDFdxf:二维轮廓与下料图step-parts:检索现成 STEP 标准件dfam-check/dfm:打印与机加/钣金/注塑可制造性检查urdf/srdf/sdf:机器人与仿真描述gcode/bambu-labs/sendcutsend:切片与外发前检查
实测
- 版本对齐:仓库 tag
v0.10.4与 PyPIcad-server==0.10.4同日(2026-11-06);Release 说明提到导出公差在含松散边时的行为与依赖更新。 - Skill 数量:在
v0.10.4树下统计到 12 个skills/*/SKILL.md,与 README 表格一致。 - 许可证:SPDX MIT;隐私政策最近更新标注为 2026-10-31。
- 遥测关闭:官方 CLI
cad telemetry off持久关闭;单进程也可用DO_NOT_TRACK=1或CAD_TELEMETRY=0。政策写明不收集提示词、模型文件、路径与文件名。 - 维护:发布日当天仍有推送,近 30 天活跃。
适合谁,不适合谁
适合:用 Claude Code / Cursor / Codex 做硬件原型、夹具、简单机构的人;需要本地保留模型脚本、导出 STEP/STL 再去打印或外协的团队。
不适合:没有较新 Python 运行时、或不想在本机跑 CAD 守护进程的环境;只要在 Blender 里做影视级网格,可看 MCP for Blender。量产和正式工艺审核仍要回到专业 CAD。
- GitHub · earthtojake/text-to-cad(README、LICENSE、v0.10.4;星数取自 API 2026-11-06)
- Release v0.10.4
- PyPI · cad-server 0.10.4
- text-to-cad 隐私政策