Bỏ qua tới nội dung
Ông T.vn

text-to-cad: nhờ AI vẽ mô hình 3D, xuất STEP/STL — hướng dẫn cài đặt và dùng

9 phút đọcCập nhật
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 giúp agent AI thiết kế sản phẩm vật lý: bạn mô tả chi tiết cần làm, agent viết script Python dựng mô hình 3D rồi hiện trong trình xem CAD. Repo dùng giấy phép MIT, có script cài một dòng cho macOS, Linux và Windows nên cài không khó.

text-to-cad là một plugin (kèm bộ skill và máy chủ MCP tên CAD) để agent AI thiết kế sản phẩm vật lý. Bạn nói bằng lời: cần một chi tiết hay một cụm lắp ráp. Agent sẽ viết mô hình thành một script Python, chạy script để dựng mô hình, rồi hiện nó trong trình xem CAD.

Repo hợp với người làm sản phẩm vật lý mà không rành phần mềm CAD: chủ xưởng nhỏ, người làm đồ chế tạo, kỹ sư muốn phác nhanh, lập trình viên mới thích thử robot hoặc in 3D. Hiện repo có khoảng 26.172 sao và 2.486 fork, giấy phép MIT.

Điểm đáng giá nhất là nó đi hết chặng, không chỉ dừng ở hình 3D. Từ mô hình, agent có thể xuất file cho in 3D hoặc cắt laser, kiểm tra khả năng gia công, tính độ bền, ra bản vẽ kỹ thuật và dựng ảnh render. Cài đặt chỉ cần một dòng lệnh.

Plugin

earthtojake/text-to-cad

Plugin giúp agent AI (Claude Code, Codex, Cursor…) viết và dựng mô hình 3D thành file STEP, STL, 3MF, GLB, kiểm tra khả năng sản xuất và xuất bản vẽ.

★ 26kPythonMIT
Xem repo trên GitHub

I.text-to-cad làm được gì

Theo README, plugin cho agent các quy trình chạy ngay trên máy bạn. Dưới đây là các nhóm tính năng chính.

  • Chi tiết và cụm lắp rápmô hình được viết bằng Python với build123d và OpenCASCADE. Bạn nhận file STEP, STL, 3MF hoặc GLB. Ngoài ra có DXF (biên dạng và hình khai triển) cho máy cắt laser, cắt tia nước. Cơ cấu chuyển động có khớp và hoạt ảnh. Vì mô hình là script, bạn sửa kích thước bằng cách nói với agent hoặc đổi một con số.
  • Mạch insơ đồ và board KiCad được bố trí, đi dây, kiểm tra ERC/DRC, rà soát trước khi đặt làm, rồi xuất file sản xuất.
  • Kiểm tra khả năng sản xuấtchi tiết có gia công, cắt và gấp, đúc khuôn hoặc in 3D được không, so với quy tắc của từng quy trình. Nếu không được, nó gợi ý nên sửa gì, sửa ở đâu.
  • Kiểm tra ứng suấtgiải bằng CalculiX cho một chi tiết hoặc cụm các chi tiết dán với nhau. Bạn có ứng suất đỉnh, hệ số an toàn và độ dịch chuyển, vẽ ngay lên mô hình.
  • Bản vẽ kỹ thuậtPDF có kích thước, chiếu từ hình học thật của chi tiết, gồm 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 bằng Blender, chạy trên GPU, có bản nháp nhanh trước khi dựng bản cuối.
  • Dịch vụ gia côngkiểm tra file DXF và STEP theo hướng dẫn của SendCutSend trước khi tải lên. Plugin cũng cắt lớp bản in bằng OrcaSlicer rồi gửi sang Bambu Connect hoặc Bambu Studio.
  • Robot và mô phỏngURDF cho ROS, SRDF cho MoveIt và MJCF cho MuJoCo.

Plugin chạy với agent nào hỗ trợ plugin hoặc skill. Trong repo có sẵn các file cấu hình cho Claude, Codex, Cursor và Gemini.

II.Cần chuẩn bị gì

Tư liệu của repo nói rất í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 riêng cho từng hệ.
  • Ít nhất một ứng dụng agent đã cài trên máy, ví dụ Claude Code hay Claude Desktop. Script cài sẽ tự cấu hình cho mọi ứng dụng agent nó tìm thấy.
  • Công cụ uv. Không có sẵn cũng không sao vì script tự cài.
  • Phần render bằng Blender chạy trên GPU. README không nói bắt buộc phải có GPU cho phần còn lại.

README không nêu phiên bản Python hay Node cần dùng, cũng không nói cần API key riêng. Phần chi phí của agent do tài khoản agent của bạn quyết định. Muốn rõ hơn, xem docs/install.md trong repo.

Cả hai lệnh cài đều tải một script từ mạng rồi chạy luôn. Trước khi chạy, bạn nên mở địa chỉ script trên trình duyệt để đọc qua. Mặc định công cụ cũng gửi thống kê sử dụng và báo lỗi (gắn ID ngẫu nhiên, không kèm file, đường dẫn hay prompt của bạn). Cách tắt có trong chính sách quyền riêng tư trên trang chủ.

III.Cài đặt từng bước

  1. Mở terminalmacOS/Linux dùng Terminal, Windows dùng PowerShell
  2. Chạy lệnh càiMột dòng lệnh tương ứng hệ điều hành của bạn
  3. Khởi động lại ứng dụng agentLàm theo danh sách ứng dụng mà script báo
  4. Kiểm tra lệnh cadChạy cad doctor --check
  5. Nhờ agent dựng thửMô tả một chi tiết và xem trong trình xem CAD

A.Mở đúng cửa sổ dòng lệnh

Trên macOS hoặc Linux, mở Terminal. Trên Windows, mở PowerShell (không dùng Command Prompt vì lệnh bên dưới viết cho PowerShell). Không cần đứng trong thư mục nào cả, và không cần tải repo về trước.

B.Chạy lệnh cài

macOS và Linux:

Terminal
curl -fsSL https://texttocad.dev/install.sh | sh

Windows, trong PowerShell:

PowerShell
irm https://www.texttocad.dev/install.ps1 | iex

Cả hai lệnh làm cùng một việc: tải script cài đặt rồi chạy. Theo README, script sẽ:

  1. Cài uv nếu máy chưa có.
  2. 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. Agent có plugin thì nhận plugin (gồm skill và máy chủ MCP của CAD). Agent chưa có plugin thì chỉ nhận skill. Claude Code nhận skill, còn Claude Desktop nhận máy chủ cho cả tab Chat và Code.
  3. Đăng ký lệnh cad.
  4. Chuyển máy chủ CAD sang bản mới.

Chỗ người mới hay vấp: dán nguyên một dòng, không tách ra, và đợi chạy xong rồi mới đóng cửa sổ.

C.Khởi động lại ứng dụng agent

Khi cài xong, script liệt kê các ứng dụng cần khởi động lại. Bạn tắt 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

Muốn cài tay từng ứng dụng thì xem docs/install.md trong repo. Muốn cập nhật, chạy lại đúng lệnh cài ở trên, hoặc bấm nút cập nhật của CAD khi nó hiện ra.

IV.Kiểm tra đã chạy được chưa

README nhắc đến lệnh kiểm tra này:

Terminal
cad doctor --check

Lệnh này kiểm tra tình trạng cài đặt, và tác giả cũng dùng kết quả của nó khi bạn báo lỗi. README không mô tả đầu ra mong đợi cụ thể, nên bạn cứ xem nó có báo lỗi hay không.

Cách thử trực quan hơn: mở ứng dụng agent và nhờ một việc đơn giản, ví dụ: Tạo một hộp 40x30x20 mm có bo góc 2 mm. Theo README, agent sẽ viết script Python, chạy để dựng mô hình và hiện nó trong trình xem CAD. Thấy mô hình xuất hiện là cài thành công.

V.Dùng vào việc thật

Các tình huống dưới đây bám theo khả năng được liệt kê trong README. Câu lệnh mẫu chỉ là gợi ý cách nói, bạn tự chỉnh kích thước cho đúng nhu cầu.

A.Chủ shop làm giá đỡ điện thoại để in 3D

Bạn bán đồ phụ kiện và muốn một giá đỡ riêng có khắc không gian cho cáp sạc. Bạn nhờ agent:

text
Thiết kế giá đỡ điện thoại, nghiêng 60 độ, có rãnh cho cáp sạc ở đáy. Xuất STL và kiểm tra xem in 3D được không.

Agent dựng mô hình, kiểm tra theo quy tắc in 3D và nói chỗ nào cần sửa. Với máy Bambu, plugin còn cắt lớp bằng OrcaSlicer rồi gửi sang Bambu Connect hoặc Bambu Studio. Bạn nhận một file in được thay vì tự học phần mềm CAD.

B.Xưởng nhỏ đặt cắt tấm kim loại

Bạn cần một tấm chắn có lỗ bắt vít để cắt laser. Bạn nhờ xuất biên dạng DXF rồi kiểm tra theo hướng dẫn của SendCutSend:

text
Làm tấm gá 120x80 mm, 4 lỗ bắt vít ở bốn góc. Xuất DXF và kiểm tra file theo SendCutSend trước khi tôi tải lên.

Bạn biết file có lỗi trước khi gửi đi, đỡ mất một vòng chờ đợi và sửa file.

Bạn mô tả bằng lời, mô hình nằm trong một script Python nên sửa lại chỉ mất một câu.

Ông T

C.Kỹ sư kiểm tra độ bền một chi tiết

Bạn có một chi tiết chịu lực và muốn biết nó có an toàn không. Bạn nhờ:

text
Kiểm tra ứng suất cho chi tiết này với tải 200 N ở đầu tự do, cho tôi hệ số an toàn và độ võng.

Plugin giải bằng CalculiX. Bạn nhận ứng suất đỉnh, hệ số an toàn và độ dịch chuyển, vẽ trên mô hình. Đây là bước tính nhanh để định hướng, quyết định cuối vẫn nên có người có chuyên môn xem lại.

D.Lập trình viên mới thử robot và bản vẽ

Bạn đang học robotics và cần mô tả robot để mô phỏng. Bạn nhờ agent dựng một cánh tay hai khớp rồi xuất mô tả URDF cho ROS hoặc MJCF cho MuJoCo. Khi cần nộp hoặc đưa đi gia công, bạn nhờ thêm bản vẽ PDF có kích thước và khung tên. Cả hai đều nằm trong danh sách tính năng của README.

VI.Lỗi hay gặp và cách xử lý

A.Lệnh cad không được nhận

Thường do cửa sổ terminal được mở trước khi cài xong nên chưa nhận lệnh mới. Hãy đóng terminal, mở lại rồi chạy cad doctor --check. Nếu vẫn lỗi, chạy lại lệnh cài, vì README nói chạy lại sẽ cập nhật mọi thứ.

B.Agent không thấy plugin hoặc skill

Đây là lỗi dễ gặp nhất. Hãy tắt hẳn ứng dụng agent rồi mở lại, theo danh sách mà script cài in ra. Nếu agent của bạn chưa có plugin, README nói có thể mở issue để xin, trong lúc chờ nó vẫn dùng được skill.

C.Lệnh cài chạy lỗi vì mạng hoặc quyền

Hai lệnh đều tải script từ trang texttocad.dev, nên mạng chặn hoặc tường lửa công ty có thể làm hỏng. Bạn thử lại ở mạng khác. Nếu không được, cài thủ công từng ứng dụng theo docs/install.md.

D.Mô hình không ra đúng ý

Agent có thể hiểu sai mô tả, nhất là khi bạn không ghi kích thước. Hãy nêu số đo, đơn vị và vị trí lỗ thật rõ. Tác giả cũng khuyến khích bạn báo chỗ skill làm sai trên Discord vì đó là cách nó được cải thiện.

E.Báo lỗi không ai hiểu

Khi cần mở issue, hãy đính kèm script mô hình và kết quả của cad doctor --check. README nói đó là kiểu báo lỗi được sửa nhanh nhất. Lỗi bảo mật thì báo riêng tư theo SECURITY.md, đừng đăng công khai.

VII.Có nên dùng không

Điểm mạnh: cài một dòng, miễn phí theo giấy phép MIT và chạy trên macOS, Linux, Windows. Mô hình là script Python nên dễ sửa và dễ lưu lại. Phạm vi rộng: từ file in 3D, bản vẽ, kiểm tra độ bền đến render và robot, trong cùng một chỗ. Repo còn được cập nhật trong vài tháng gần đây.

Giới hạn: bạn vẫn cần một ứng dụng agent và chi phí của nó. Đây là công cụ hỗ trợ, không thay cho kỹ sư khi sản phẩm cần an toàn thật. Kết quả kiểm tra ứng suất hay khả năng sản xuất nên được người có chuyên môn xem lại. Mặc định có gửi thống kê ẩn danh, bạn nên đọc chính sách quyền riêng tư nếu làm việc với dữ liệu nhạy cảm. Một số tính năng như Blender, KiCad hay slicer phụ thuộc phần mềm bên ngoài, và README không nói rõ bạn có phải tự cài thêm không, nên cần xem docs/install.md.

Khi nên chọn cách khác: nếu bạn đã quen phần mềm CAD kéo thả và chỉ cần vẽ vài chi tiết nhanh, dùng thẳng phần mềm đó có thể nhanh hơn. Nếu bạn cần mô hình điêu khắc hay hình dáng tự do nhiều, cách viết script theo hình học có thể không hợp.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

text-to-cad có miễn phí không?

Bản thân repo dùng giấy phép MIT, tức là mã nguồn mở. Chi phí của ứng dụng agent bạn dùng (Claude, Cursor, Codex…) là chuyện riêng. README không nói về giá của các dịch vụ đó.

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.

Cần GPU không?

README chỉ nói phần render bằng Blender chạy trên GPU. Với phần dựng mô hình, README không nêu yêu cầu GPU, nên bạn xem docs/install.md nếu muốn chắc.

Dữ liệu và file của tôi có an toàn không?

Các quy trình chạy cục bộ trên máy bạn. 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 và không kèm file, đường dẫn hay prompt của bạn. Cách tắt có trong chính sách quyền riêng tư trên trang chủ.

Nó xuất ra những định dạng file nào?

STEP, STL, 3MF và GLB cho mô hình 3D, DXF cho biên dạng và hình khai triển, PDF cho bản vẽ kỹ thuật. Ngoài ra có file sản xuất cho mạch in KiCad và URDF, SRDF, MJCF cho robot.

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. Repo có sẵn cấu hình cho Claude, Codex, Cursor và Gemini. Agent chưa có plugin thì có thể yêu cầu tác giả hỗ trợ qua issue.

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 của CAD khi nó hiện ra. Sau đó khởi động lại những ứng dụng mà script liệt kê.

Chuyển nhanh tới mục

  1. I.text-to-cad làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở đúng cửa sổ dòng lệnh
    2. B.Chạy lệnh cài
    3. C.Khởi động lại ứng dụng agent
    4. D.Cài thủ công hoặc cập nhật
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop làm giá đỡ điện thoại để in 3D
    2. B.Xưởng nhỏ đặt cắt tấm kim loại
    3. C.Kỹ sư kiểm tra độ bền một chi tiết
    4. D.Lập trình viên mới thử robot và bản vẽ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh cad không được nhận
    2. B.Agent không thấy plugin hoặc skill
    3. C.Lệnh cài chạy lỗi vì mạng hoặc quyền
    4. D.Mô hình không ra đúng ý
    5. E.Báo lỗi không ai hiểu
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.