Design with your Agent. Inspect, refine, cut, and assemble.
An open-source AI design workbench for laser-cut and knife-cut models. Your coding Agent creates the design; the browser shows the exact parts and lets you adjust them.
简体中文 · Design Skill · Project format
- See the whole build: orbit the 3D model, select parts, explode it, and play assembly one part at a time.
- Refine the real geometry: adjust dimensions, thickness and fit; pin notes to parts; edit custom outlines; move and rotate sheet placements. Solid intersections and continuous linear insertion collisions are reported.
- Prepare fabrication: export SVG/DXF, artwork, fit coupons, editable source and assembly instructions.
- Show how it is made: preview cutting paths and automatically record a captioned 720p assembly tutorial.
Node.js 22 or newer. No model account or API key required.
npm ci
npm run devOpen the localhost URL printed by Vite. Open this repository in your coding Agent and ask it to use $design-flatpack-models. The Agent and browser share .cuttobuild/session.json.
Three editable studies are included: a plywood rover, a courtyard house, and a card racer. Original designs use custom planar contours, connections and assembly steps; they are not limited to these examples.
Try the original 31-part tank → Geometry checks, sheet layout, assembly and automatic tutorial recording.
npm run cli -- inspect
npm run cli -- feedback
npm run cli -- patch edit.json
npm run cli -- validate
npm run cli -- export --format bundle --out exports/my-modelThe browser is a viewer and editor, with no prompt/chat input. Static builds support browser storage and JSON import/export; the local Agent bridge runs with npm run dev.
| Output | Purpose |
|---|---|
| SVG, DXF | Millimeter-scale cutting contours |
| PNG, JPG/JPEG, BMP, WebP | Print artwork and image previews |
| ZIP | Cutting files, artwork, source, notes, guide, report and fit coupon |
| WebM, or a supported browser video codec | Automatically recorded 1280×720 tutorial with captions and no audio |
Laser contours already include kerf compensation. Disable additional compensation in downstream software. Print registration and machine settings remain device-specific. Native AI and LAC export are not implemented; they need verified external adapters.
Digital geometry checks and insertion animations do not prove physical fit, assembly paths or structural strength. Test a coupon and verify the actual material before fabrication. Example rover wheels are fixed decorative parts, attached with glue.
npm run check
npx playwright install chromium
npm run test:e2eSee architecture, research, verification and contributing. npm run build creates a static dist/ bundle. A hosted deployment is not included.
加入造物矩阵 → 展示作品、交换反馈，继续把想法做出来。
🎁 使用 GITHUB 领取月度会员：长期有效，每个账号限兑换一次。礼物由项目作者提供，与 GitHub 平台无关联。
我是 Cell 细胞。我写代码，也写文章，把好奇心做成作品，探索更独立的工作与生活方式。
个人站 · 造物矩阵 · X / @cellinlab
扫码加我的微信，备注 GitHub。
 个人微信 |
 视频号 |
 公众号 |
如果这个项目对你有帮助，欢迎支持我继续做下去。
 支付宝 |
 微信 |
MIT. Original template copyright is retained. Brand assets identify Maker Matrix and are separate from the code license.