过去一年里,「文字生成 CAD」从演示视频变成了真实可用的工具。但绝大多数同类产品是闭源的 SaaS——你只能用,看不到它怎么把一句话变成实体,也无法自己部署一套。CADAM 打破的正是这一点:它是目前最完整的开源 text-to-CAD Web 应用,在浏览器里跑,从一句自然语言描述直接产出一个可参数化的三维模型。
一、项目速览
- 仓库:github.com/Adam-CAD/CADAM
- 定位:开源的文字转 CAD 网页应用
- 在线体验:adam.new/cadam(无需安装)
- 技术栈:TypeScript + React 19 + TanStack Start
- 开源许可:GPL v3.0
- 社区热度:5,436 star、672 fork(截至 2026 年 11 月 17 日)
- 发布时间:2025 年 9 月首次开源,最近一次提交在 2026 年 10 月
- 运行要求:Node.js 20.19+ 或 22.12+,npm 10+
二、它是怎么把一句话变成模型的
CADAM 走的不是「AI 直接输出几何」的路线,而是把 AI 当作代码生成器:
- 你用中文或英文描述想要的零件,也可以上传一张参考图;
- 模型服务调用大语言模型,生成一段 OpenSCAD 脚本;
- OpenSCAD 通过 WebAssembly 在浏览器本地编译,得到真实实体几何,无需服务端渲染;
- Three.js / React Three Fiber 把结果画出来,实时可见;
- 系统从脚本里自动提取可调尺寸,在右侧生成一排滑块。
这个设计有个很实际的后果:拖动滑块时不需要再调用一次 AI。参数变化只触发 OpenSCAD 重新编译,所以调节是即时的、不消耗 token,也不会因为模型「发挥」而偏离原设计。

界面上还保留了版本记录(截图里的 v1、4/4 翻页)、模型颜色选择,以及右下角一键导出 STL 的按钮。整套流程都在一个页面里完成。
三、核心特性
- 自然语言 + 图片输入:可以纯文字描述,也可以传参考图辅助生成
- 参数化控制:自动识别出可调尺寸,滑块即时生效
- 智能更新:改参数不重新走 AI 生成,效率与稳定性都更好
- 多格式导出:.STL、.SCAD、.DXF
- 纯浏览器运行:基于 WebAssembly,几何计算在本机完成
- 库支持:内置 BOSL、BOSL2、MCAD 三个 OpenSCAD 常用库
- 字体支持:内置 Geist 字体,方便在模型上做文字
四、它到底能做出什么
仓库里有一组公开的基准测试,每个模型都只给一句话描述,产出的是完整可参数化的 OpenSCAD 代码,而不是一坨网格。这套用例很能说明能力边界:
复杂机械与装配体:V8 内燃机(22 个尺寸参数、8 种颜色)、9 缸星形航空发动机、高涵道比涡扇发动机、轴向涡轮叶盘。

参数化零件:扭曲六边形花瓶、滚花旋钮、带真实螺纹的 M12 六角螺栓与螺母、蜂窝减重支架、NACA 2412 锥形翼、螺纹罐与旋盖、直角锥齿轮传动、离心泵叶轮、人字齿行星齿轮级。
值得注意的是「真实螺纹」「NACA 翼型」「人字齿」这类细节——它们不是靠视觉上像,而是靠 OpenSCAD 的正规几何构造出来的,因此导出的 STL 可以直接送去打印或做后续处理。
五、技术栈
- 前端:React 19 + TypeScript + TanStack Start + Vite
- 三维渲染:Three.js + React Three Fiber
- CAD 引擎:OpenSCAD WebAssembly
- 后端:TanStack Start 服务端路由 + Supabase(PostgreSQL / Auth / Storage)
- AI:Anthropic Claude API 为主,环境变量里同时预留了 OpenRouter、OpenAI、Google、FAL 等 provider 的密钥位
- 样式:Tailwind CSS + shadcn/ui
把几何计算放在浏览器里是个关键选择:模型的编译不占用服务器资源,预览延迟低,也意味着大规模并发时后端压力主要在大模型调用这一侧。
六、自己跑一套
官方给出的本地启动流程很短:
git clone https://github.com/Adam-CAD/CADAM.git
cd CADAM
npm install
# 启动本地 Supabase 与服务
npx supabase start
npx supabase functions serve --no-verify-jwt
# 启动前端
npm run dev
环境变量分前后端两套:前端只需要 Supabase 的 URL 与 anon key;服务端则要配 ANTHROPIC_API_KEY、OPENROUTER_API_KEY、OPENAI_API_KEY、GOOGLE_API_KEY、FAL_KEY、Supabase service role key,以及计费服务的地址与密钥。因为要接收 provider 回调,本地开发还需要 ngrok 打一个公网隧道,把生成的地址填进 WEBHOOK_BASE_URL。
换句话说,想完整跑起来需要准备多家 AI 服务商的密钥,这是评估自建成本时最容易低估的一项。
七、许可与来源
CADAM 采用 GPL v3.0。这一点对打算二次开发或商业集成的人很重要:GPLv3 具有传染性,基于它修改后分发需要同样开源。仓库也说明了来源——部分代码派生自 openscad-web-gui(GPLv3),并包含 OpenSCAD WASM 的未修改二进制(GPL v2 或更高,在本项目中以 GPLv3 分发)。
它站在一长串开源工作之上:OpenSCAD、openscad-wasm、openscad-playground、openscad-web-gui、dingcad,README 里都做了明确致谢。
八、客观地看它的边界
- 它是脚本路线,不是 BRep 内核路线。生成的中间产物是 OpenSCAD 代码,几何能力受 OpenSCAD 的 CSG 建模方式限制,与商用 CAD 的特征建模、直接编辑曲面还有距离。
- 输出质量取决于生成的脚本。基准测试里漂亮的结果来自打磨过的提示词;换到你自己领域的专业零件,仍需要人工检查代码或调整描述。
- 导出格式有限:STL / SCAD / DXF,没有 STEP、IGES 这类工程交换格式。
- 自建成本不低:多家 AI provider 的密钥、Supabase、计费服务、ngrok,缺一不可。
- GPLv3 对商业闭源集成构成约束。
九、值得一看的理由
如果你在做 AI 与 CAD 的结合,CADAM 是一个难得的完整参考实现:它把「自然语言 → 代码 → 几何 → 参数化控制」这条链路走通了,而且每一段都开源可读。特别是把参数提取与 AI 生成解耦这个设计——生成一次、之后纯本地调参——在成本与稳定性上都是明显更优的工程选择。
如果你只是想快速得到可打印的模型,直接在 adam.new/cadam 上试一句描述就行,或者克隆下来跑一套自己的实例。
项目地址:https://github.com/Adam-CAD/CADAM
在线体验:https://adam.new/cadam
许可:GNU General Public License v3.0






