에이전트에게 CAD 초능력 주는 text-to-cad, 1.7만 개 스타로 검증된 라이브러리

설계 도면을 그리는 데 며칠을 쓰던 시절이 끝났습니다. 텍스트 한 줄이나 이미지 한 장으로 STEP·STL·3MF·GLB까지 뽑아주는 text-to-cad가 에이전트 워크플로에 그대로 녹아듭니다. 1.7만 개 스타와 MIT 라이선스, 반 년 넘게 이어진 업데이트로 검증된 이 라이브러리를 실무에 붙이는 법을 단계별로 짚어드립니다.

text-to-cad란 무엇인가요

text-to-cad는 AI 에이전트에게 CAD 능력을 부여하는 오픈소스 라이브러리예요. 1.7만 개 스타를 받은 검증된 프로젝트로, MIT 라이선스로 공개돼 누구나 자유롭게 쓸 수 있어요. 6개월 전(2026년 4월) 처음 만들어졌고, 이번 달(2026년 10월)에도 활발히 업데이트되고 있어요.

이 라이브러리의 핵심은 '스킬(Skill)' 단위로 CAD 워크플로를 쪼개서 에이전트에 꽂아 쓸 수 있게 한 점이에요. 자연어 지시나 이미지 한 장만으로 3D 모델을 생성·수정하고, 결과를 STEP(.stp/.step)을 기본으로 STL, 3MF, GLB까지 한 번에 내보낼 수 있어요. CAD 설계뿐 아니라 로봇 설명 파일(URDF/SDF) 생성, 시뮬레이션 입력 준비, 슬라이싱·제작 핸드오프까지 한 흐름으로 이어집니다.

주요 스킬과 역할

내부는 Python 기반이며 build123d / pythonOCC(OpenCASCADE) 같은 검증된 커널 위에서 동작해요. 에이전트가 로컬 프로젝트 파일만으로 모델을 생성·검토·전달까지 끝내도록 설계돼 있어, 클라우드 의존 없이 보안·속도 모두 챙길 수 있어요.

1. Skills CLI로 설치(권장)

   npx skills add earthtojake/text-to-cad — 같은 명령으로 업데이트도 가능해요. npx skills update만 쓰면 새로 추가된 스킬을 놓칠 수 있으니 add를 쓰세요.

2. 직접 클론해서 쓰기

   git clone https://github.com/earthtojake/text-to-cad.git 후 각 스킬의 requirements.txt에 고정된 cadgen 버전을 설치하면 됩니다.

• 라이선스: MIT
• 주 언어: Python
• 포크: 1,736개
• 문서: https://www.texttocad.dev
• 커뮤니티: Discord(https://discord.gg/5FGB9DwJYU)

왜 이 라이브러리를 쓰나요

text-to-cad는 CAD 모델링 전 과정—생성·편집·검증·슬라이싱·핸드오프—을 에이전트 스킬 단위로 쪼개 제공합니다. 자연어 지시나 이미지 한 장만 던지면 STEP을 주산출물로 내놓고, 필요에 따라 STL·3MF·GLB까지 한 번에 뽑아주니 포맷 변환 스크립트를 따로 짜지 않아도 됩니다.

각 스킬은 독립적인 requirements.txt로 cadgen 버전을 고정하므로, 프로젝트마다 의존성이 꼬일 걱정 없이 조립·재사용이 가능합니다. 새 스킬이 추가되면 npx skills add 한 번으로 즉시 반영되고, 쓰지 않는 스킬은 npx skills remove로 걷어내면 되니 에이전트 툴체인을 가볍게 유지하기 좋습니다.

설치·사용 3단계

텍스트-투-캐드는 Skills CLI로 설치·업데이트·제거를 모두 관리해요. npx skills add earthtojake/text-to-cad 한 줄이면 저장소 main 브랜치에서 최신 스킬을 받아와 에이전트에 등록하고, 같은 명령어를 다시 실행하면 새로운 스킬까지 자동으로 추가돼요. npx skills update는 이미 락파일에 있는 스킬만 갱신하므로, 릴리스마다 스킬이 늘어나는 이 프로젝트에서는 add를 쓰는 게 안전해요.

npx skills add earthtojake/text-to-cad

각 스킬 폴더 안의 requirements.txt에는 해당 스킬이 테스트된 cadgen 버전이 핀닝(pinning)돼 있어요. 덕분에 전역 파이썬 환경이 꼬이지 않고, 스킬별로 의존성이 격리돼 재현 가능한 빌드가 가능합니다. 저장소 루트의 models/ 픽스처 코퍼스는 런타임에 필요 없으니 클론하지 않아도 돼요.

npx skills remove cad-viewer

1. 설치

   npx skills add earthtojake/text-to-cad로 최신 스킬 전체를 에이전트에 등록합니다.

2. 업데이트

   동일 명령어를 주기적으로 다시 실행해 신규 스킬까지 반영합니다.

3. 제거

   불필요하거나 퇴역한 스킬은 npx skills remove <스킬명>으로 정리합니다.

주요 스킬 한눈에 보기

text-to-cad 라이브러리는 AI 에이전트에게 CAD·DXF·로봇 설명·시뮬레이션·로컬 리뷰 등 5가지 주요 스킬을 제공합니다. 각각의 스킬은 자연어 혹은 이미지 기반 지시를 받아 입력을 받고, STEP·DXF·URDF·시뮬레이션 설정 파일 등 출력을 만들어 줍니다. 1.7만 개 스타를 받은 검증된 프로젝트라 믿고 사용하셔도 됩니다.

아래 표에서는 각 스킬별 대표 입력·출력·활용 시나리오를 한눈에 비교할 수 있습니다. 에이전트가 어떤 작업을 수행해야 할 때 필요한 스킬을 골라 명령만 주면, 복잡한 CAD 파이프라인을 자동으로 처리해 줍니다.

npx skills add earthtojake/text-to-cad

주의할 점·함정 피하기

Skills CLI로 text‑to‑cad를 관리할 때 흔히 겪는 함정이 있습니다. npx skills update 명령은 현재 lockfile에 기록된 스킬만 다시 다운로드하기 때문에, 새 릴리스에 추가된 스킬을 자동으로 가져오지 않아요. 따라서 최신 기능을 사용하려면 npx skills add earthtojake/text-to-cad 명령을 한 번 더 실행해 새 스킬을 받아와야 합니다. 또, 저장소에서 퇴역된 스킬은 자동으로 삭제되지 않으니 직접 제거해야 하는데, 대표적인 예가 cad‑viewer 스킬입니다. 이 스킬은 이제 CAD, DXF, 로봇 설명 스킬에 포함돼 있으니 npx skills remove cad‑viewer 로 삭제해 주세요. 마지막으로, models/ 폴더에 있는 fixture corpus는 실제 스킬 실행에 필요하지 않으니, 설치 과정에서 신경 쓰지 않아도 됩니다.

npx skills add earthtojake/text-to-cad
npx skills remove cad-viewer

• 1. 업데이트 시 npx skills add 로 전체 패키지를 재설치한다.
• 2. 퇴역 스킬이 있으면 npx skills remove <스킬명> 으로 삭제한다.
• 3. models/ 폴더는 무시해도 된다.

위 체크리스트를 따라 하면 최신 CAD 초능력을 놓치지 않고, 불필요한 파일도 깔끔하게 관리할 수 있습니다.

• 원문 보기