text-to-cad: dùng AI thiết kế sản phẩm 3D ra file STEP, STL — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về earthtojake/text-to-cad — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: text-to-cad: nhờ AI vẽ mô hình 3D, xuất STEP/STL — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
text-to-cad là plugin và bộ skill cho AI agent (Claude Code, Codex, Cursor, Gemini…), cho phép bạn mô tả một chi tiết hay cụm lắp ráp bằng lời, agent sẽ viết script Python dựng mô hình và hiện trong CAD viewer. Repo dùng giấy phép MIT. Cài bằng một dòng lệnh, khá dễ nếu bạn đã quen dùng một agent.
text-to-cad là một plugin (kèm bộ skill và máy chủ MCP) giúp AI agent thiết kế sản phẩm vật lý. Bạn mô tả một chi tiết hoặc cụm lắp ráp, agent viết mô hình thành script Python, chạy script để dựng ra file 3D, rồi hiện ngay trong CAD viewer. Repo hiện có khoảng 26.230 sao và 2.489 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.
Người nên thử là chủ shop muốn tự làm phụ kiện in 3D, kỹ sư hoặc maker cần dựng nhanh chi tiết cơ khí, và lập trình viên mới thích kiểu thiết kế bằng code thay vì kéo thả trong phần mềm CAD. Bạn không cần biết dùng phần mềm CAD truyền thống, nhưng cần có sẵn một ứng dụng agent trên máy.
Điểm đáng giá nhất: không chỉ vẽ hình. Cùng một bộ công cụ còn kiểm tra khả năng sản xuất, tính ứng suất, xuất bản vẽ kỹ thuật, render ảnh, thậm chí chuẩn bị file để gửi in 3D hoặc cắt kim loại.
earthtojake/text-to-cad
Plugin giúp AI agent viết mô hình 3D bằng Python, xuất STEP/STL/3MF, kiểm tra khả năng sản xuất, vẽ bản vẽ kỹ thuật và kết nối dịch vụ gia công.
I.text-to-cad làm được gì
Theo tác giả, plugin cho agent các quy trình chạy cục bộ để tạo mô hình 3D dạng STEP, GLB, STL hoặc 3MF, kiểm tra để sản xuất, vẽ bản vẽ và kết nối dịch vụ in 3D, gia công kim loại tấm, CNC. Nó hoạt động với mọi agent hỗ trợ plugin hoặc skill. Cụ thể:
- Chi tiết và cụm lắp ráp. Mô hình được viết bằng Python với build123d và OpenCASCADE. Bạn lấy ra STEP, STL, 3MF, GLB, hoặc DXF (biên dạng và bản trải phẳng cho cắt laser, cắt tia nước). Có cả khớp và hoạt ảnh cho cơ cấu chuyển động. Lợi ích: mô hình là một đoạn code, muốn đổi kích thước chỉ cần sửa con số rồi chạy lại.
- Mạch in. Sơ đồ nguyên lý và bo mạch KiCad được đặt linh kiện, đi dây, kiểm tra ERC và DRC, xem lại trước khi đặt làm, rồi xuất file sản xuất.
- Kiểm tra khả năng sản xuất. Chi tiết có gia công, cắt và gấp, đúc khuôn hay in 3D được không, so với quy tắc của từng quy trình, và nếu không được thì nên sửa gì, sửa ở đâu. Bạn biết lỗi thiết kế trước khi tốn tiền làm thật.
- Kiểm tra độ bền. Dùng CalculiX để xem chi tiết hoặc cụm các chi tiết dán liền có chịu nổi tải không: ứng suất đỉnh, hệ số an toàn, độ dịch chuyển, vẽ ngay lên mô hình.
- Bản vẽ kỹ thuật. Tờ PDF có kích thước, chiếu từ hình học của chi tiết: các hình chiếu, nét khuất, dấu tâm, chú thích lỗ và khung tên.
- Render. Ảnh tĩnh, video xoay và phim của mô hình bằng Blender, chạy trên GPU, có bản nháp nhanh trước khi render bản cuối.
- Dịch vụ gia công. Kiểm tra file DXF và STEP theo hướng dẫn của SendCutSend trước khi bạn tải lên, và cắt lớp bản in 3D bằng OrcaSlicer rồi gửi sang Bambu Connect hoặc Bambu Studio.
- Robot và mô phỏng. Mô tả robot và thế giới: URDF cho ROS, SRDF cho MoveIt, MJCF cho MuJoCo.
II.Cần chuẩn bị gì
README nói khá ít về yêu cầu, nên mình chỉ nêu những gì có trong tư liệu:
- Một ứng dụng agent trên máy. Trình cài đặt sẽ tự cài text-to-cad vào mọi ứng dụng agent nó tìm thấy. README nhắc Claude Code và Claude Desktop (tab Chat và Code), và nói plugin chạy với bất kỳ agent nào hỗ trợ plugin hoặc skill.
- Hệ điều hành. macOS, Linux và Windows đều có lệnh cài riêng. Windows dùng PowerShell.
- Kết nối mạng để tải trình cài đặt. Trình cài sẽ tự cài uv nếu máy chưa có.
- GPU chỉ được nhắc ở phần render Blender (chạy trên GPU). README không nói các tính năng khác bắt buộc GPU.
- Tài khoản, API key, phiên bản Node hay Python: README chưa ghi yêu cầu cụ thể nào. Nếu bạn dùng agent có tài khoản hoặc key riêng thì đó là việc của ứng dụng agent đó, không phải của repo này.
Lệnh cài đặt tải một script từ internet rồi chạy ngay. Nếu bạn muốn chắc ăn, hãy mở địa chỉ script trong trình duyệt đọc trước khi chạy. Ngoài ra, mặc định công cụ gửi thống kê sử dụng và báo lỗi (gắn ID ngẫu nhiên, không gồm file, đường dẫn hay prompt của bạn). Chính sách quyền riêng tư của dự án nói rõ gửi gì và cách tắt.
III.Cài đặt từng bước
- Mở terminalmacOS/Linux mở Terminal, Windows mở PowerShell
- Chạy lệnh càiDán một dòng lệnh theo hệ điều hành của bạn
- Khởi động lại ứng dụng agentTrình cài sẽ liệt kê ứng dụng cần khởi động lại
- Kiểm tra bằng cad doctorChạy lệnh kiểm tra để chắc mọi thứ đã sẵn sàng
- Nhờ agent tạo thử một chi tiếtMô tả bằng lời và xem trong CAD viewer
A.Mở terminal đúng chỗ
Trên macOS hoặc Linux, mở ứng dụng Terminal. Trên Windows, mở PowerShell (gõ PowerShell vào ô tìm kiếm của Start). Lệnh cài không phụ thuộc thư mục hiện tại nên bạn không cần cd vào đâu cả.
B.Chạy lệnh cài
macOS và Linux:
curl -fsSL https://texttocad.dev/install.sh | shWindows, trong PowerShell:
irm https://www.texttocad.dev/install.ps1 | iexHai lệnh này tải script cài đặt rồi chạy luôn. Theo README, script sẽ làm các việc sau: cài uv nếu máy chưa có; cài text-to-cad vào mọi ứng dụng agent trên máy bằng chính lệnh của từng ứng dụng (plugin gồm skill và máy chủ MCP của CAD; với agent chưa có plugin thì chỉ cài skill; Claude Code nhận skill, Claude Desktop nhận máy chủ cho tab Chat và Code); đăng ký lệnh cad; và chuyển máy chủ CAD sang bản mới.
Chỗ người mới hay vấp: dán nhầm lệnh của hệ điều hành khác. Lệnh có curl ... | sh là cho macOS/Linux, lệnh có irm ... | iex là cho PowerShell trên Windows.
C.Khởi động lại ứng dụng agent
Sau khi cài, script sẽ liệt kê các ứng dụng cần khởi động lại. Hãy đóng hẳn rồi mở lại những ứng dụng đó để chúng nhận plugin mới.
D.Cài thủ công hoặc cập nhật
Chạy lại đúng lệnh cài ở trên là cập nhật mọi thứ. Khi CAD hiện nút cập nhật thì bạn cũng có thể bấm nút đó. Nếu muốn cài thủ công từng ứng dụng một, README chỉ sang file docs/install.md trong repo. Mình khuyên bạn xem file đó nếu ứng dụng agent của bạn không được trình cài tự nhận ra.
Nếu bạn dùng agent chưa có plugin, README nói bạn có thể mở một issue để xin; repo cũng có sẵn các file cấu hình như claude.mcp.json, codex.mcp.json, cursor.mcp.json, nhưng cách dùng chúng không được giải thích trong README, nên hãy đọc docs/install.md.
IV.Kiểm tra đã chạy được chưa
README không có mục kiểm tra cài đặt riêng, nhưng có nhắc hai thứ bạn dùng được:
- Lệnh
cadđã được đăng ký. Mở terminal mới và chạy lệnh dưới đây. README nhắc nó khi hướng dẫn báo lỗi, tức là công cụ chẩn đoán dùng để kiểm tra tình trạng cài đặt:
cad doctor --check- Thử bằng agent. Theo README, bạn chỉ cần nhờ agent làm một chi tiết hoặc cụm lắp ráp: nó sẽ viết mô hình thành script Python, chạy script để dựng mô hình và hiện trong CAD viewer. Nếu bạn thấy mô hình xuất hiện trong viewer thì xem như thành công.
README không ghi chính xác màn hình kết quả của cad doctor --check trông thế nào, nên mình không đoán. Nếu lệnh báo lỗi, hãy giữ nguyên nội dung đó để dùng khi hỏi trên Discord hoặc mở issue.
V.Dùng vào việc thật
Dưới đây là vài tình huống bám đúng khả năng mà README mô tả. Prompt chỉ là ví dụ, bạn thay kích thước và yêu cầu của mình vào.
A.Chủ shop làm giá đỡ điện thoại để in 3D
Bạn bán phụ kiện bàn làm việc và muốn tự làm một giá đỡ điện thoại in bằng máy Bambu. Mở agent đã cài text-to-cad và nhập:
Thiết kế giá đỡ điện thoại để bàn, góc nghiêng khoảng 60 độ, đế rộng 80 mm,
có khe cho dây sạc. Xuất STL, kiểm tra xem in 3D được không.Agent viết script Python dựng mô hình, hiện trong CAD viewer, xuất STL và chạy kiểm tra khả năng in 3D, chỉ ra chỗ nên sửa nếu có. Với dịch vụ in, README nói công cụ có thể cắt lớp bằng OrcaSlicer rồi gửi sang Bambu Connect hoặc Bambu Studio. Bạn nhờ agent làm bước đó khi mô hình đã ổn.
Mô hình là một đoạn script: muốn đổi kích thước, bạn sửa một con số rồi chạy lại, không phải vẽ lại từ đầu.
Ông T
B.Kỹ sư nhỏ kiểm tra giá treo có chịu tải không
Bạn là kỹ sư ở xưởng nhỏ, cần một giá treo thiết bị và muốn biết nó có gãy không trước khi gia công. Nhờ agent:
Tạo giá treo hình chữ L bằng nhôm, tải 20 kg đặt ở đầu tự do.
Kiểm tra khả năng gia công CNC và tính ứng suất, hệ số an toàn.Theo README, phần kiểm tra độ bền dùng CalculiX và trả về ứng suất đỉnh, hệ số an toàn và độ dịch chuyển của từng chi tiết, vẽ lên mô hình. Kết quả là bạn có số liệu để quyết định có cần dày thêm hay không. Hãy coi đây là bước sàng lọc ban đầu, không thay thế việc kiểm định chuyên môn cho sản phẩm có yêu cầu an toàn.
C.Nhân viên kỹ thuật chuẩn bị file cắt kim loại tấm
Bạn cần cắt laser một tấm bracket. Nhờ agent tạo chi tiết kim loại tấm, xuất DXF dạng trải phẳng, rồi kiểm tra DXF/STEP theo hướng dẫn của SendCutSend trước khi tải lên:
Làm tấm bracket thép 2 mm, có 4 lỗ bắt vít, xuất DXF trải phẳng
và kiểm tra theo hướng dẫn của SendCutSend.Kết quả: file DXF cho cắt laser hoặc cắt tia nước, cùng danh sách điểm cần chỉnh nếu file chưa đạt yêu cầu của dịch vụ. Bạn đỡ phải tải lên rồi mới bị trả về.
D.Lập trình viên robot dựng mô tả robot
Bạn làm robot trong ROS hoặc MuJoCo và cần file mô tả. README nói công cụ tạo được URDF cho ROS, SRDF cho MoveIt và MJCF cho MuJoCo:
Tạo robot tay máy 3 khớp xoay, xuất URDF để dùng trong ROS.Bạn nhận một mô tả robot sát với mô hình CAD, làm điểm xuất phát cho mô phỏng và lập kế hoạch chuyển động. Bạn vẫn cần tự kiểm tra thông số khớp, khối lượng, giới hạn trước khi dùng thật.
VI.Lỗi hay gặp và cách xử lý
A.Gõ cad báo không tìm thấy lệnh
Thường do terminal đang mở từ trước khi cài nên chưa nhận lệnh mới. Đóng terminal, mở cửa sổ mới rồi thử lại. Nếu vẫn không được, chạy lại lệnh cài, đây là cách cập nhật và sửa cài đặt mà README đề xuất.
B.Agent không thấy plugin hay skill
Bạn chưa khởi động lại ứng dụng agent sau khi cài. Hãy đóng hẳn rồi mở lại ứng dụng nằm trong danh sách mà trình cài đưa ra. Nếu ứng dụng của bạn không có trong danh sách, xem docs/install.md để cài thủ công, hoặc xin hỗ trợ bằng cách mở issue.
C.Chạy lệnh cài báo lỗi mạng hoặc bị chặn
Lệnh cần tải script từ website của dự án, nên mạng công ty hoặc tường lửa chặn là có thể hỏng. Thử lại bằng mạng khác. Đừng tắt các biện pháp bảo mật của máy chỉ để cho lệnh chạy được; hãy dùng cài thủ công trong docs/install.md.
D.Render chậm hoặc không chạy
README nói render bằng Blender chạy trên GPU. Nếu máy bạn không có GPU phù hợp, tính năng này có thể chậm hoặc không dùng được. README chưa nói rõ trường hợp này, nên hãy dùng bản nháp nhanh trước, và hỏi trên Discord của dự án nếu cần.
E.Mô hình ra sai hoặc không như mong đợi
Agent có thể hiểu sai kích thước. Hãy nói cụ thể đơn vị (mm), số lượng lỗ, độ dày, và yêu cầu nó chạy lại phần kiểm tra khả năng sản xuất. Nếu nghi do lỗi của công cụ, README khuyên gửi báo cáo kèm script mô hình và kết quả của cad doctor --check, vì cách này giúp tác giả sửa nhanh nhất.
VII.Có nên dùng không
Điểm mạnh. Bạn có cả chuỗi việc trong một chỗ: từ mô tả bằng lời, ra mô hình, kiểm tra sản xuất, tính độ bền, bản vẽ, render, đến chuẩn bị file gửi gia công. Mô hình là script Python nên dễ sửa, dễ lưu và dễ chia sẻ. Giấy phép MIT, phát triển công khai, cài bằng một dòng lệnh. Dự án cũng khá được quan tâm với khoảng 26.230 sao.
Giới hạn. Bạn cần một ứng dụng agent và chất lượng kết quả phụ thuộc vào cách bạn mô tả cũng như vào agent. README chưa ghi yêu cầu phiên bản Node hay Python, cũng không hứa kết quả cho mọi loại chi tiết. Mặc định công cụ có gửi thống kê và báo lỗi ẩn danh, bạn nên đọc chính sách quyền riêng tư và tắt nếu không muốn. Các phần kiểm tra độ bền hay kiểm tra sản xuất chỉ là hỗ trợ, không thay thế kỹ sư cho sản phẩm có yêu cầu an toàn.
Khi nào chọn cách khác. Nếu bạn cần thiết kế thủ công rất tinh chỉnh bằng giao diện đồ hoạ, hoặc không muốn dùng agent AI, một phần mềm CAD truyền thống sẽ hợp hơn. Còn nếu bạn muốn nhanh chóng đi từ ý tưởng đến file in được hay file cắt được, text-to-cad đáng để thử một buổi chiều.
Câu hỏi thường gặp
text-to-cad có miễn phí không?
Repo dùng giấy phép MIT và được phát triển công khai nên mã nguồn dùng tự do. README không nói gì về chi phí của ứng dụng agent bạn dùng cùng hoặc của các dịch vụ gia công, nên phần đó bạn cần tự kiểm tra.
Máy tôi chạy Windows thì cài được không?
Được. README có lệnh riêng cho Windows chạy trong PowerShell: irm https://www.texttocad.dev/install.ps1 | iex. macOS và Linux dùng lệnh curl khác.
Có cần GPU không?
README chỉ nhắc GPU ở phần render bằng Blender, nơi việc render chạy trên GPU. Các tính năng khác không được nói là bắt buộc GPU, nhưng README cũng chưa nêu cấu hình tối thiểu.
Dữ liệu và file của tôi có bị gửi đi không?
Theo README, mặc định công cụ gửi thống kê sử dụng và báo lỗi, gắn với một ID ngẫu nhiên và không bao gồm file, đường dẫn hay prompt của bạn. Chính sách quyền riêng tư của dự án nói rõ gửi gì và cách tắt.
Dùng với agent nào được?
README nói nó chạy với mọi agent hỗ trợ plugin hoặc skill, và trình cài đặt tự cài vào mọi ứng dụng agent trên máy, trong đó có Claude Code và Claude Desktop. Repo cũng có file cấu hình cho Codex, Cursor và Gemini; agent chưa có plugin thì có thể xin qua issue.
Khác gì việc tự vẽ trong phần mềm CAD?
Ở đây mô hình được agent viết thành script Python (build123d và OpenCASCADE) rồi chạy ra file, thay vì bạn thao tác bằng chuột. Bù lại, công cụ nối sẵn với kiểm tra sản xuất, tính độ bền, bản vẽ, render và dịch vụ gia công. README không so sánh trực tiếp với phần mềm CAD cụ thể nào.
Cập nhật phiên bản mới thế nào?
Chạy lại đúng lệnh cài là cập nhật mọi thứ, hoặc bấm nút cập nhật khi CAD hiện nút đó. Trình cài sẽ liệt kê các ứng dụng bạn cần khởi động lại.


