text-to-cad: thiết kế sản phẩm vật lý bằng AI — 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 (như Claude Code, Codex, Cursor, Gemini), giúp agent tạo mô hình CAD 3D từ mô tả bằng lời. Agent viết mô hình thành script Python, chạy ra file STEP, STL, 3MF hoặc GLB rồi hiển thị trong trình xem CAD. Cài đặt chỉ cần một dòng lệnh cho macOS, Linux hoặc Windows.
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 bằng lời, agent viết mô hình thành script Python, chạy script để dựng mô hình 3D rồi mở nó trong trình xem CAD. Repo viết bằng Python, giấy phép MIT, hiện có khoảng 26.230 sao và 2.489 fork.
Repo này hợp với người muốn làm ra đồ thật nhưng không muốn học phần mềm CAD từ đầu: chủ shop làm phụ kiện, người hay in 3D, kỹ sư cơ khí muốn có bản nháp nhanh, dev mới tò mò về robot. Bạn không phải kéo chuột vẽ từng nét. Bạn nói chuyện với agent, nó viết code, còn bạn xem kết quả và sửa bằng lời.
Điểm đáng giá nhất là repo không dừng ở việc ra một hình 3D. Nó còn kiểm tra xem chi tiết có gia công, in hay đúc được không, tính độ bền, xuất bản vẽ kỹ thuật có kích thước và nối thẳng sang dịch vụ in 3D hay cắt kim loại. Cài đặt khá nhẹ: một dòng lệnh là xong.
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ụ in 3D, cắt kim loại.
I.text-to-cad làm được gì
Theo README, plugin cho agent của bạn các quy trình chạy ngay trên máy để tạo mô hình 3D, kiểm tra khả năng sản xuất, vẽ bản vẽ và kết nối dịch vụ in 3D, cắt kim loại, CNC. Nó chạy với bất kỳ agent nào hỗ trợ plugin hoặc skill. Các tính năng chính:
- Chi tiết và cụm lắp ráp. Mô hình được viết thành script Python bằng build123d và OpenCASCADE. Bạn lấy ra file STEP, STL, 3MF hoặc GLB. Ngoài ra có DXF (profile và hình khai triển phẳng) cho máy cắt laser, cắt tia nước. Cơ cấu chuyển động có khớp và hoạt ảnh. Lợi ích thực tế: mô hình là code, nên muốn đổi kích thước chỉ cần bảo agent sửa một thông số.
- Mạch in (PCB). Làm sơ đồ và board KiCad, đặt linh kiện, đi dây, kiểm tra bằng ERC và DRC, rà lại trước khi đặt làm, rồi xuất file sản xuất. Bạn bắt được lỗi mạch trước khi tốn tiền gia công.
- 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ên sửa gì nếu chưa đạt. Việc này tiết kiệm nhiều lần làm hỏng mẫu.
- Kiểm tra độ bền. Dùng CalculiX để xem chi tiết (hoặc cụm gồm nhiều chi tiết dán với nhau) 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. Xuất PDF có kích thước, chiếu từ hình học thật của chi tiết: các hình chiếu, đường khuất, dấu tâm, chú thích lỗ và khung tên. Bạn đưa thẳng cho xưởng.
- Render. Ảnh tĩnh, video xoay (turntable) và phim ngắn với Blender, ánh sáng và khung hình viết bằng script Python, chạy bằng GPU, có bản nháp nhanh trước khi dựng bản cuối. Hợp làm ảnh giới thiệu sản phẩm.
- Dịch vụ gia công. Kiểm tra file DXF và STEP theo hướng dẫn của SendCutSend trước khi tải lên, cắt lớp (slice) 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 mô phỏng: URDF cho ROS, SRDF cho MoveIt, MJCF cho MuJoCo.
II.Cần chuẩn bị gì
Tư liệu repo nói khá ít về yêu cầu, nên mình chỉ ghi những gì có:
- Một máy macOS, Linux hoặc Windows. README có lệnh cài riêng cho cả ba.
- Ít nhất một ứng dụng AI agent hỗ trợ plugin hoặc skill. README nhắc Claude Code, Claude Desktop và nói script cài sẽ thiết lập cho mọi ứng dụng agent có trên máy. Repo cũng có file cấu hình cho Codex, Cursor và Gemini.
- Công cụ uv. Bạn không cần cài trước: script cài sẽ tự cài uv nếu máy chưa có.
- Riêng phần render bằng Blender, README nói chạy trên GPU. Các tính năng còn lại, tư liệu không ghi yêu cầu phần cứng.
- Về tài khoản hay API key: README không nhắc. Bạn vẫn cần tài khoản hoặc gói dùng của ứng dụng agent bạn chọn, vì agent là phần làm việc chính.
Về phiên bản Node hay Python cụ thể, README chưa ghi. Nếu cần, xem docs/install.md trong repo.
III.Cài đặt từng bước
- Mở terminalmacOS/Linux mở Terminal, Windows mở PowerShell
- Chạy lệnh càiDán đúng một dòng lệnh theo hệ điều hành của bạn
- Khởi động lại ứng dụng agentScript sẽ liệt kê những app cần mở lại
- Kiểm tra bằng cad doctorChạy lệnh kiểm tra để chắc đã cài ổn
- Nhờ agent tạo thử một chi tiếtMô tả bằng lời và xem trong trình xem CAD
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). Bạn không cần cd vào thư mục nào, vì lệnh cài tự tải mọi thứ cần.
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 | iexCả hai lệnh tải một script cài đặt từ website của dự án rồi chạy luôn. Theo README, script làm các việc sau:
- Cài uv nếu máy chưa có.
- Thiết lập text-to-cad trong mọi ứng dụng agent trên máy bằng chính lệnh của từng ứng dụng. Agent có plugin thì nhận plugin (gồm skill và máy chủ MCP của CAD). Agent chưa có plugin thì nhận riêng skill. Claude Code nhận skill, còn Claude Desktop nhận máy chủ cho cả tab Chat và Code.
- Đăng ký lệnh
cad. - Chuyển máy chủ CAD sang bản phát hành mới.
Chỗ người mới hay vấp: trên Windows phải dùng PowerShell, không dán lệnh curl ... | sh vào đó. Trên macOS/Linux thì ngược lại, chỉ dùng dòng curl.
Cả hai lệnh đều tải script từ internet rồi chạy ngay. Nếu bạn muốn yên tâm, hãy mở địa chỉ script trên trình duyệt đọc trước khi chạy, hoặc xem hướng dẫn cài thủ công trong docs/install.md của repo.
C.Khởi động lại ứng dụng agent
Sau khi cài xong, script liệt kê những ứng dụng cần khởi động lại. Hãy đóng hẳn các app đó rồi mở lại để chúng nhận plugin mới.
D.Cập nhật về sau
Muốn cập nhật, chạy lại đúng lệnh cài ở trên. Theo README, chạy lại sẽ cập nhật mọi thứ. Khi nút cập nhật hiện ra trong CAD, bạn cũng có thể bấm nút đó, và nó sẽ liệt kê app cần khởi động lại.
E.Cài thủ công từng app
Nếu một app không nhận bằng script, README chỉ sang file docs/install.md trong repo để cài tay từng ứng dụng. Mình không chép lại ở đây vì tư liệu chưa nêu chi tiết lệnh.
IV.Kiểm tra đã chạy được chưa
Có hai cách, theo tư liệu:
- Chạy lệnh kiểm tra mà README nhắc tới khi báo lỗi:
cad doctor --checkĐây là lệnh chẩn đoán của cad. README không mô tả đầu ra chi tiết, nhưng nếu lệnh chạy được tức là lệnh cad đã được đăng ký. Nếu báo lỗi, bạn sẽ dùng chính đầu ra này khi nhờ cộng đồng hỗ trợ.
- Thử thật: mở ứng dụng agent của bạn và nhờ nó làm một chi tiết đơn giản. Theo README, agent sẽ viết mô hình thành script Python, chạy script để dựng mô hình rồi hiện trong trình xem CAD. Thấy mô hình 3D hiện ra là cài thành công.
Nếu máy bạn mở được trình xem nhưng agent không thấy skill, hãy kiểm tra lại bước khởi động lại ứng dụng ở trên.
V.Dùng vào việc thật
README chỉ nói chung là bạn "hỏi agent về một chi tiết hoặc cụm lắp ráp". Các prompt dưới đây là ví dụ mình đặt ra, bám đúng những khả năng repo liệt kê. Bạn tự sửa số đo cho hợp việc của mình.
Mô hình là một đoạn code, nên đổi kích thước chỉ là đổi một con số.
Ông T
A.Chủ shop làm phụ kiện in 3D
Bối cảnh: bạn bán đồ để bàn và cần một cái giá đỡ điện thoại có logo riêng. Bạn mô tả bằng lời cho agent:
Thiết kế giá đỡ điện thoại, rộng 80 mm, nghiêng 65 độ, có rãnh cho dây sạc. Xuất file 3MF để in 3D.Agent viết script, dựng mô hình và xuất file. Bạn xem trong trình xem CAD, bảo agent chỉnh (dày hơn, bo góc), rồi nhờ nó kiểm tra xem chi tiết in 3D được không. Nếu có Bambu Studio hoặc Bambu Connect trên máy, repo hỗ trợ cắt lớp bằng OrcaSlicer và gửi bản in sang đó.
B.Nhân viên văn phòng đặt cắt tấm kim loại
Bối cảnh: công ty cần vài tấm bracket thép cắt laser để treo thiết bị. Bạn nhờ agent:
Làm tấm bracket phẳng có 4 lỗ bắt vít, xuất DXF. Kiểm tra file theo hướng dẫn của SendCutSend trước khi tôi tải lên.Kết quả: file DXF hình khai triển phẳng, kèm báo cáo kiểm tra theo hướng dẫn của SendCutSend. Bạn sửa lỗi ngay trước khi gửi đặt hàng, đỡ bị trả file.
C.Kỹ sư kiểm tra độ bền và gửi bản vẽ cho xưởng
Bối cảnh: bạn có một chi tiết chịu tải và cần biết có an toàn không, đồng thời cần bản vẽ để đưa xưởng gia công. Bạn nhờ:
Kiểm tra độ bền chi tiết này với tải 200 N ở đầu tự do. Cho tôi ứng suất đỉnh, hệ số an toàn, rồi xuất bản vẽ PDF có kích thước.Kết quả theo README: số liệu ứng suất, hệ số an toàn, độ dịch chuyển vẽ lên mô hình, và bản vẽ PDF gồm hình chiếu, chú thích lỗ, khung tên. Đây là kiểm tra bằng mô phỏng, nên với chi tiết quan trọng bạn vẫn cần kỹ sư có chuyên môn xác nhận.
D.Dev mới làm robot hoặc ảnh quảng cáo sản phẩm
Bối cảnh: bạn tập làm cánh tay robot nhỏ hoặc cần ảnh đẹp của sản phẩm. Với robot, bạn nhờ agent viết mô tả URDF (cho ROS) hoặc MJCF (cho MuJoCo). Với ảnh, bạn nhờ:
Dựng ảnh render tĩnh của mô hình này bằng Blender, làm bản nháp trước rồi mới dựng bản cuối.Bạn nhận được ảnh render (hoặc video xoay) mà không phải tự học Blender. Nhớ rằng render chạy trên GPU.
VI.Lỗi hay gặp và cách xử lý
- Gõ lệnh cài trong sai terminal. Lệnh
curl ... | shdành cho macOS/Linux, cònirm ... | iexdành cho PowerShell trên Windows. Dán nhầm sẽ báo lỗi ngay. Hãy mở đúng terminal rồi chạy lại. - Agent không thấy plugin hay skill. Thường do chưa khởi động lại ứng dụng. Đóng hẳn app, mở lại. Nếu vẫn không được, chạy lại lệnh cài hoặc xem docs/install.md để cài tay cho từng app.
- Lệnh
cadkhông nhận ra. Mở cửa sổ terminal mới sau khi cài, rồi chạycad doctor --check. Nếu vẫn lỗi, chạy lại lệnh cài. - Mô hình không như ý. Agent dựng theo mô tả, nên mô tả mơ hồ thì ra kết quả lệch. Hãy nêu số đo, số lỗ, vật liệu và cách sản xuất. Nhờ agent chạy kiểm tra khả năng sản xuất để biết cần sửa gì.
- Cần báo lỗi. Theo README, một báo cáo lỗi kèm script mô hình và đầu ra của
cad doctor --checklà loại được sửa nhanh nhất. Vấn đề bảo mật thì báo riêng tư theo SECURITY.md, đừng đăng công khai.
Mặc định, text-to-cad gửi thống kê sử dụng và báo cáo sự cố, gắn với một ID ngẫu nhiên, và README nói không bao giờ 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êu rõ gửi gì và cách tắt. Hãy đọc trước nếu bạn làm việc với thiết kế nhạy cảm.
VII.Có nên dùng không
Điểm mạnh:
- Một dòng lệnh để cài, chạy trên macOS, Linux và Windows.
- Mô hình là script Python, dễ sửa thông số, dễ lưu và kiểm soát phiên bản.
- Phạm vi rộng: từ chi tiết cơ khí, mạch in, kiểm tra sản xuất, độ bền, bản vẽ, render đến robot.
- Nối được tới quy trình thật: SendCutSend, OrcaSlicer, Bambu.
- Giấy phép MIT, repo vẫn được cập nhật trong 3 tháng gần đây và có Discord để hỏi.
Giới hạn:
- Chất lượng phụ thuộc vào agent và mô tả của bạn. Với chi tiết phức tạp, bạn sẽ phải lặp qua lại nhiều lần.
- Kiểm tra độ bền và khả năng sản xuất là công cụ hỗ trợ, không thay thế kỹ sư cho đồ chịu tải hoặc liên quan an toàn.
- README chưa ghi yêu cầu phiên bản cụ thể hay cấu hình máy tối thiểu, ngoại trừ việc render chạy trên GPU.
- Cài bằng cách chạy script tải từ internet, và mặc định có gửi thống kê ẩn danh. Bạn cân nhắc theo mức yên tâm của mình.
Khi nên chọn cách khác: nếu bạn đã quen một phần mềm CAD dạng kéo thả và chỉ cần vẽ vài nét, dùng luôn phần mềm đó sẽ nhanh hơn. Nếu bạn không dùng AI agent nào, repo này không có nhiều ý nghĩa vì nó được thiết kế để agent điều khiển. Còn nếu bạn muốn đi từ ý tưởng đến file in hay file cắt thật nhanh, và chịu làm việc bằng lời, text-to-cad đáng thử.
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 dùng mã nguồn không mất phí. README không nói gì về chi phí của ứng dụng agent bạn dùng cùng nó, nên phần đó bạn cần xem gói của chính app đó.
Có chạy được trên Windows không?
Có. README có lệnh cài riêng cho Windows, chạy trong PowerShell, bên cạnh lệnh cho macOS và Linux. Lệnh cài sẽ tự cài uv nếu máy chưa có.
Có cần GPU không?
README chỉ nhắc GPU ở phần render bằng Blender, nơi cảnh được dựng trên GPU. Với các tính năng khác, tư liệu không nêu yêu cầu phần cứng.
Dữ liệu của tôi có an toàn không?
Theo README, mặc định công cụ gửi thống kê sử dụng và báo cáo sự cố, gắn với một ID ngẫu nhiên và không bao giờ 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. README không giải thích thêm về việc agent bạn chọn xử lý dữ liệu thế nào.
Dùng với agent nào được?
README nói nó chạy với bất kỳ agent nào hỗ trợ plugin hoặc skill, và script cài thiết lập cho mọi ứng dụng agent có trên máy. Tư liệu nhắc cụ thể Claude Code và Claude Desktop. Repo cũng có file cấu hình cho Codex, Cursor và Gemini. Agent chưa có plugin có thể yêu cầu qua issue.
Xuất ra được những định dạng file nào?
Mô hình 3D xuất ra STEP, STL, 3MF hoặc GLB. Có DXF cho profile và hình khai triển phẳng dùng cắt laser hoặc tia nước, PDF cho bản vẽ kỹ thuật, và file sản xuất cho mạch in. Phần robot có URDF, SRDF và MJCF.
Gặp lỗi thì hỏi ở đâu?
Bạn mở issue trên GitHub, kèm script mô hình và đầu ra của lệnh cad doctor --check để được sửa nhanh nhất. Có thêm Discord để hỏi, chia sẻ sản phẩm đã làm. Lỗi bảo mật thì báo riêng tư theo SECURITY.md.


