text-to-cad

面向 CAD/机器人/硬件设计的 LLM agent 技能库，通过自然语言或图片生成 STEP、STL 等三维模型，并支持 URDF、G-code 等多种工业格式。亮点在于直接集成到 Codex、Claude Code 等主流 agent 中，让 AI 完成从设计到制造的全流程，减少人工建模的重复劳动。MIT 开源，适合需要快速原型生成的硬件团队。

README

 ██████╗ █████╗ ██████╗       ███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
██╔════╝██╔══██╗██╔══██╗      ██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
██║     ███████║██║  ██║      ███████╗█████╔╝ ██║██║     ██║     ███████╗
██║     ██╔══██║██║  ██║      ╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
╚██████╗██║  ██║██████╔╝      ███████║██║  ██╗██║███████╗███████╗███████║
 ╚═════╝╚═╝  ╚═╝╚═════╝       ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝

针对 CAD、机器人学及硬件设计 agent 的技能库

Docs | Demo

CAD Skills

CAD Skills 是一个 agent 技能库，用于从本地项目文件中生成、检查、采购、切片和交接 CAD 及机器人描述工件。

🧰 技能

安装本库，可为 agent 提供针对 CAD、制造、机器人描述文件、仿真和本地审查的聚焦工作流。

技能	概述	来源
CAD	根据自然语言或图像请求创建和编辑 CAD 模型，以 STEP 为主输出格式，同时支持导出为 STL、3MF 和 GLB。	skills/cad
CAD Viewer	在本地浏览器中预览 CAD、G-code 和机器人文件。	skills/cad-viewer
step.parts	查找现成的 STEP 标准件，如螺丝、轴承、电机和连接器。	skills/step-parts
DXF	从 Python 源码或 CAD 几何体创建 2D DXF 图纸，如型材、模板、垫片和切割排版。	skills/dxf
URDF	编写机器人结构文件，包含连杆、关节、极限、惯性和网格。	skills/urdf
SRDF	为 URDF 添加 MoveIt 规划组、末端执行器、姿态和碰撞规则。	skills/srdf
SDF	创建仿真模型和世界场景，包含框架、物理引擎、传感器和灯光。	skills/sdf
SendCutSend	在上传至 SendCutSend 之前检查 DXF 和 STEP 文件。	skills/sendcutsend
G-code	使用真实切片器 CLI 将支持的网格文件切片为经过验证、适配打印机的 FDM `.gcode` 文件。	skills/gcode
Bambu Labs	对经过验证的 `.gcode` 文件进行空跑、上传，并谨慎启动本地 Bambu Lab 打印任务。	skills/bambu-labs
Implicit CAD	使用 GLSL signed-distance fields（有符号距离场）和 CAD Viewer 光线步进渲染，创建浏览器原生的隐式 CAD 模型。实验性功能。	skills/implicit-cad

💻 安装

生产环境使用中，请从 main 分支安装或克隆；该分支包含了 provider 安装器所需的已生成技能/插件输出。

技能

使用 Skills CLI 安装 CAD Skills：

npx skills install earthtojake/text-to-cad

这是推荐的安装方式。它将各个技能直接安装到支持的 agent 中。

插件

Codex 和 Claude Code 也支持 provider 原生插件安装：

# Codex
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad

# Claude Code
claude plugin marketplace add earthtojake/text-to-cad
claude plugin install cad@text-to-cad

如果新安装的技能未出现，请重启 agent。本地开发请从 develop 分支创建分支，向 develop 分支提 PR，并使用 CONTRIBUTING.md 中的符号链接工作流。

📸 截图

CAD

URDF

SRDF / MoveIt2

🧪 基准测试

仓库将重资产文件存储在 assets/** 和 benchmarks/** 中，通过 Git LFS 管理，并将这些目录排除在默认 LFS 拉取之外，以便轻量级克隆不会获取 GIF 资产。基准测试的 markdown 文件保留为普通 Git 文件，便于差异阅读。如需在本地仅拉取基准测试资产，请运行：

git lfs pull --include="benchmarks/**"

#	目标	提示
1	带四个通孔的长方校准块	创建一个居中放置的 100 x 60 x 20 mm 方块，带有四个 8 mm 垂直通孔。仅在顶部外周边添加 2 mm 倒角。
2	带螺栓孔阵列的圆形法兰	创建一个直径 80 mm、厚 10 mm 的圆形法兰，中心有一个 30 mm 通孔。在直径 60 mm 的螺栓圆周上添加六个 6 mm 通孔，并对外侧圆形边缘进行倒圆角。
3	带加强筋和两种方向孔的 L 形支架	创建一个由底板和后垂直板组成的 L 形支架。添加垂直底板孔、水平背板孔、两个三角形加强筋，并对底板/背板过渡处进行圆角处理。
4	带键槽的阶梯轴	创建一个沿 X 轴、长度为 120 mm 的轴，具有 20/30/20 mm 直径的阶梯段。在两端添加倒角，并在中间段顶部添加一个浅矩形键槽。
5	带支柱的开顶电子外壳	创建一个空心开顶外壳，壁厚和底板厚均为 3 mm。在内部添加四个带有居中盲孔的支柱，并在外部垂直角落添加 2 mm 圆角。
6	带减重孔的航空航天式叉形支架	创建一个对称的叉形支架，包含底板、两个圆角凸耳、底板安装孔和一个水平凸耳孔。添加三角形减重孔、加强筋和圆角过渡。
7	星形发动机式气缸（带散热片）	创建一个垂直的发动缸体造型，包括中心缸体、12 个散热片、底座法兰和顶部缸盖。添加一个 35 度倾斜的火花塞凸台，带有同轴通孔。
8	带后弯叶片的离心叶轮	创建一个离心叶轮，包含背板、轮毂和通孔。添加 12 个融合的后弯叶片，从根部到尖端扫掠约 45 度。
9	带螺旋扶手的螺旋楼梯	创建一个微型螺旋楼梯，包含中心柱、底座圆盘和 20 个上升楔形踏板。添加一圈螺旋扶手以及踏板外端的垂直栏杆。
10	简化的行星齿轮级	创建一个扁平的行星齿轮组件，包含独立的太阳轮、行星轮、齿圈、行星架和销轴。使用简化的梯形齿，将三个行星轮围绕太阳轮布置在直径为 42 mm 的圆上。