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 核心
- 預設會傳送使用統計與當機報告;可以關閉
- 主要由一位維護者開發,每隔幾天就發布新版本