text-to-cad
AI 코딩 에이전트가 Python CAD로 부품을 설계하고 로봇을 MuJoCo로 내보내게 해 줍니다
라이선스
MIT
코드와 skills: MIT이며, earthtojake/text-to-cad의 LICENSE 파일과 각 skill 폴더의 LICENSE 파일에서 확인했습니다(저작권자 Thompson Labs LLC). 에이전트 앱: text-to-cad에는 별도의 AI 에이전트 앱이 필요하며, 그 앱의 약관이 적용됩니다. 서비스: SendCutSend와 Bambu Lab은 각자의 약관이 있는 외부 업체의 서비스이며, skills는 파일을 검사하고 준비할 뿐 주문하지 않습니다. 텔레메트리: 끄지 않으면 사용 횟수와 충돌 보고서가 api.texttocad.dev로 전송되며, 모델, 프롬프트, 파일 경로는 전송되지 않습니다. 카드 이미지: 프로젝트 자체의 소셜 미리보기 이미지를 잘라낸 것으로, 코드 라이선스의 적용을 받지 않습니다. 2026-11-13에 LICENSE 파일, README, 개인정보 처리방침으로 확인했습니다.
개요
text-to-cad는 Claude Code, Codex, Cursor, Gemini CLI 같은 AI 코딩 에이전트가 실물 부품과 어셈블리를 설계하게 해 주는 오픈소스 플러그인입니다. 에이전트는 각 모델을 OpenCASCADE 커널 위의 build123d 라이브러리로 작성한 Python 스크립트로 쓰고, 실행한 뒤, 결과를 로컬 CAD 뷰어에 보여 줍니다. 모델은 STEP, STL, 3MF, GLB, DXF 파일로 내보낼 수 있습니다. 다른 skills는 부품을 절삭 가공, 절단과 굽힘, 사출 성형, 3D 프린팅으로 만들 수 있는지 확인하고, CalculiX로 강도를 검토하고, 치수가 들어간 PDF 도면을 그리고, Blender로 이미지를 렌더링하고, KiCad로 회로 기판을 설계하고, OrcaSlicer로 출력물을 슬라이싱하고, SendCutSend의 주문 가이드에 맞춰 파일을 확인합니다. 로보틱스 쪽으로는 모델의 관절과 재료에서 URDF, SRDF, MJCF 로봇 기술 파일을 만들며, 2026년 11월의 0.11.8 릴리스부터 MuJoCo 4를 지원합니다. 질량과 관성은 CAD에서 나오고, 검사 기능이 MuJoCo에서 모델을 컴파일하며, 로봇과 장면은 Python으로 구성합니다. 프로젝트는 earthtojake가 만들었고 MIT 라이선스이며, 모든 것이 사용자 자신의 컴퓨터에서 실행됩니다.
text-to-cad는 에이전트용 skills와, 코딩 에이전트가 MCP로 호출하는 로컬 CAD 서버로 이루어져 있습니다. 설치 스크립트는 찾아낸 모든 에이전트 앱에 이를 설정합니다. Claude Code, Claude Desktop, Codex, Cursor, Grok Build, Gemini CLI는 플러그인을 받고, GitHub Copilot, Windsurf, Cline, Zed 등 열다섯 개 정도의 다른 에이전트는 skills만 받습니다. 도구 자체는 Python 패키지 cad이며 uv로 실행합니다. 프로젝트 사이트는 texttocad.dev입니다.
모델은 OpenCASCADE 커널 위에서 build123d로 작성한 Python 스크립트입니다. CAD skill은 에이전트가 이를 실행해 CAD 뷰어에 보여 주고, STEP, STL, 3MF, GLB로, 또는 레이저와 워터젯 절단용 DXF 윤곽과 전개도로 내보내게 합니다. 어셈블리에는 관절과 애니메이션을 넣을 수 있습니다. 나머지 skills는 절삭 가공, 판금, 사출 성형, 3D 프린팅의 제조 가능성 검사, 선형 정적 강도 검토(CalculiX를 쓰는 유한 요소법), PDF 기술 도면, Blender 렌더링, KiCad 회로 기판, OrcaSlicer 슬라이싱과 Bambu Lab 프린터로의 전송, 그리고 SendCutSend 주문 사전 점검을 다룹니다.
로봇 시뮬레이션 skill은 모델의 관절, 재료, 이름 붙은 좌표계를 ROS 2용 URDF, MoveIt용 SRDF, MuJoCo용 MJCF로 바꿉니다. 2026년 11월 11일의 0.11.8 릴리스에서 MuJoCo 4.0.0 지원이 추가되었습니다.
- 각 링크의 질량, 질량 중심, 관성은 CAD 커널을 거쳐 부품의 재료에서 나오며, 명령 하나로 로봇을 MJCF나 URDF로 내보냅니다. - 평범한 Python 함수가 MuJoCo 자체의 spec 위에서 시뮬레이션 선택을 합니다. 기본 도형으로 맞춘 충돌 형상이나 CoACD로 나눈 볼록 껍질(볼록 분해), 관절 감쇠, 액추에이터, 센서입니다. - cad mujoco check 명령은 MuJoCo로 파일을 컴파일하고, 정지 상태에서 서로 파고드는 부품, 잘못된 스케일, 범위를 벗어난 관절, 무엇이 무엇과 충돌하는지를 알려 줍니다. - 장면은 Python으로 구성합니다. 예를 들어 CAD로 설계한 그리퍼를 다른 곳에서 가져온 팔에 달고 집을 블록을 놓는 식이며, 브라우저의 MuJoCo Studio에서 열 수 있습니다. - ranges 명령은 각 관절을 부품끼리 닿을 때까지 움직여 관절의 한계 위치를 찾습니다.
MuJoCo 예제 프로젝트는 SO-101 팔과 Trossen WidowX AI의 제조사 STEP 파일을 이 과정에 통과시키고, 결과를 MuJoCo Menagerie의 수작업 모델과 비교합니다. 총질량 차이는 1.3%와 2.7%입니다. 프로젝트는 이를 벤치마크가 아니라 예제라고 부릅니다.
중요한 이유
대부분의 로봇은 CAD 속 부품에서 시작하지만, 그 부품에서 시뮬레이션 모델을 얻으려면 보통 상용 CAD 프로그램과 onshape-to-robot 같은 별도 변환 도구가 필요합니다. text-to-cad는 이 흐름 전체를 AI 에이전트가 쓰고 사람이 읽을 수 있는 코드로 유지합니다. 부품, 어셈블리, 관절, 질량, MuJoCo 모델이 모두 같은 Python 스크립트에서 나오므로 설계 변경은 한 번의 수정과 재실행으로 끝납니다. MuJoCo 기능은 장난감 예제가 아니라 실제 로봇인 SO-101과 WidowX AI로 검증되었습니다. SolidCraft처럼 무엇보다 범용 CAD이며, 로봇 기능은 여덟 개 skills 중 하나로, 이미 코딩 에이전트를 쓰는 사람에게 특히 유용합니다.
해결하는 문제
로봇 부품을 설계하고 그 부품이 들어가는 로봇을 시뮬레이션하려면 보통 CAD 프로그램, 질량과 관성을 맞추는 수작업, 그리고 변경할 때마다 다시 돌려야 하는 URDF나 MJCF 변환 도구가 필요합니다. text-to-cad를 쓰면 AI 에이전트가 부품을 Python 스크립트로 쓰고, 제조 가능성을 확인하고, 같은 스크립트에서 로봇 기술 파일과 MuJoCo 장면을 만들며, 물리 속성은 CAD에서 가져옵니다.
핵심 요점
- AI 코딩 에이전트가 부품과 어셈블리를 build123d Python 스크립트로 작성하게 해 주는 플러그인과 skills
- STEP, STL, 3MF, GLB, DXF로 내보내고 절삭 가공, 판금, 사출 성형, 3D 프린팅 가능성을 검사
- 모델의 관절과 재료로 URDF, SRDF, MJCF를 작성하며 질량과 관성은 CAD에서 계산
- 0.11.8 릴리스부터 MuJoCo 4 지원: MuJoCo 함수, 모델 검사, Python으로 구성하는 장면
- CalculiX 강도 검토, PDF 도면, Blender 렌더링, KiCad 기판도 지원
- MIT 라이선스. 계정 없이 로컬에서 실행되며, 끄지 않으면 사용 통계를 전송
대상
- 이미 AI 코딩 에이전트를 쓰면서 출력 부품이나 가공 부품 설계를 맡기고 싶은 로봇 제작자
- CAD를 갖고 있는 로봇의 MuJoCo나 URDF 모델이 필요한 연구자
- 주문 전에 부품을 3D 프린팅이나 판금용으로 점검하고 싶은 메이커
- 하드웨어 설계를 코드로 버전 관리하는 개발자
한계
- Claude Code, Codex, Cursor 같은 AI 에이전트 앱이 필요하며, 이들은 각자의 약관과 비용이 있는 별도 제품임
- 무엇보다 범용 CAD: 로봇 기능은 여덟 개 skills 중 하나이고, MuJoCo 지원은 2026년 11월에야 추가됨
- 기본 MJCF 내보내기에는 액추에이터, 관절 동역학, 선택한 충돌 형상이 없으며, 이는 MuJoCo 함수에서 직접 작성해야 함
- MuJoCo 예제는 벤치마크가 아님: 액추에이터 게인은 로봇이 자세를 유지하도록 고른 값이며 측정값이 아님
- 장면을 보는 데 쓰는 MuJoCo Studio는 인증 없이 모든 네트워크 인터페이스에서 대기함
- CoACD 볼록 분해는 Intel Mac, ARM용 Windows, musl Linux에서 쓸 수 없음
- 강도 검토는 선형 정적 하중만 다룸
- 설치 시 스크립트를 파이프로 셸에 넘겨 실행하고 약 240 MB의 CAD 커널을 내려받음
- 사용 통계와 충돌 보고서가 기본으로 전송되며, 끌 수 있음
- 대부분 한 명의 메인테이너가 개발하며, 며칠마다 릴리스가 나옴