AI 에이전트가 LDraw로 조립 가능한 레고 모델을 설계하는 ldraw-nova 공개

Hacker News8일 전조회 1

오픈소스 프로젝트 ldraw-nova가 공개됐다. 만들고 싶은 모델 아이디어를 AI 에이전트에게 던져주고 방향을 잡아주면, 에이전트가 스스로 계획을 세워 LDraw 언어로 레고 모델을 만들어내는 에이전트 도구 모음이다. 저자는 GPT-6 Astra와 Claude Opus 5.5로 이 도구를 구현했고, 부품·예제 모델 검색에는 TypeSafe의 Jev System One 모델을 백엔드로 쓰는 jev-rerank를 연결했다.

빌드가 끝나면 결과물이 한 덩어리로 쏟아진다. LDraw 소스 코드, 3D 뷰어와 3D 플레이어, 메타 퀘스트 3에서 동작하는 VR 인터랙티브 뷰, 렌더링 이미지가 나오고, 블렌더에서 바로 편집할 수 있는 glTF(.glb) 파일도 함께 생성된다. 이 glTF에는 모델 메타정보가 블렌더 커스텀 프로퍼티로 들어가며, 에이전트와의 채팅 기록과 사고 과정도 남는다.

작업 흐름은 부품을 하나씩 집어 넣는 방식이 아니다. 에이전트가 문서와 실험 결과를 모아 기하 구조까지 담은 계획 파일(plan.json)을 만들고, 그 계획을 해석해 생성 스크립트(generate.py)를 작성한 뒤, 스크립트를 실행해 LDraw 모델 파일을 뽑아낸다. 에이전트 → 계획 → 생성기 → 모델로 이어지는 일종의 컴파일러 구조인 셈이다. 부품 충돌과 간격 감지, 헤드리스 렌더링으로 중간 결과를 눈으로 확인하고 위치와 미관을 다듬는 과정이 도구로 지원된다.

부품 검색 품질은 외부 API 키에 달려 있다. TYPESAFE_API_KEY를 웹 앱 설정에 넣으면 시맨틱 검색과 재순위가 동작하지만, 키가 없으면 전문 검색(FTS)으로 폴백하면서 결과 모델의 품질이 떨어질 수 있다고 저자는 밝힌다.

실행은 Docker 기반이다. ldraw-nova와 ldraw-nova-docker 두 저장소를 같은 태그(v0.6.0)로 나란히 클론한 뒤 이미지를 빌드한다. 첫 빌드는 상당한 시간이 걸리고 약 5GB의 디스크 공간을 요구한다. https://localhost:8443 포트는 메타 퀘스트 3의 VR을 위해 필요하며 자체 서명 인증서 경고를 한 번 넘겨야 하고, http://localhost:8765는 인증서 경고 없는 일반 HTTP지만 VR은 동작하지 않는다. 로그인 기능이 없으므로 신뢰할 수 있는 네트워크에서만 돌려야 한다.

배경에는 LDraw라는 언어의 성격이 있다. LDraw는 부품 회전과 위치 같은 수학 연산에 크게 의존하는, 3D CAD 모델을 만들어내는 저수준 어셈블리 언어다. 저자는 ChatGPT와 Claude에게 다른 프로그래밍 언어를 다루듯 LDraw 코드를 짜게 하는 실험을 시작으로 py2bricks 같은 여러 시도를 거쳤다. 그 과정에서 얻은 결론은 명확하다. 에이전트는 기하 수학을 직접 계산하는 것보다, 그 수학을 만들어내는 파이썬 코드를 작성하는 쪽을 훨씬 잘한다는 것이다. 모델 자체를 학습 재료로 주는 것보다 모델을 생성하는 파이썬 코드를 보여주는 편이 학습 효과도 좋았다. 필요한 프리미티브와 어휘를 갖춘 파이썬 도구를 만드는 일은 오랫동안 잘 풀리지 않았지만, 최신 모델들이 등장하면서 완성됐다.

개발자 입장에서 이 프로젝트가 보여주는 것은 특정 언어의 문법이 아니라 접근법이다. 에이전트가 약한 영역을 정면으로 뚫게 하는 대신, 그 영역을 우회하는 도구와 예시, 지침을 제공하는 설계다. 계획과 생성기를 분리해 두면 결과를 검증하고 부분적으로 다시 만들기 쉬워지며, 이 구조는 CAD나 코드 생성 파이프라인 전반에 응용할 수 있다.

첫 릴리스인 만큼 남은 과제도 적지 않다. 메타 퀘스트 3의 VR은 모델 처리와 성능 문제가 많고, Luna나 Haiku 같은 저사양 모델에서도 쓸 수 있도록 도구와 문서를 다듬어야 한다. 대형 모델을 정확하게 생성하려면 현재로선 값비싼 고성능 모델이 필요하고 생성 속도도 느리다. 테크닉 계열 기계·엔진 모델과 우주선 모델의 품질은 아직 부족하며, 매뉴얼을 보고 모델을 만드는 기능은 페이지 매뉴얼을 이미지로 줄 때 부분적으로 동작한다.

이 프로젝트는 LDView, LeoCAD, LDCad와 Shadow Library, ldraw.rs, pyldraw3 등 수십 년간 LDraw 생태계에 기여해온 오픈소스 도구와 라이브러리 위에 서 있다. LEGO는 LEGO Group의 상표이며, 이 소프트웨어를 후원하거나 승인하지 않는다.