LDraw-Nova: AI 에이전트가 LEGO CAD 모델 구축

LDraw-Nova는 AI 코딩 에이전트가 .ldr 및 .mpd 소스 파일을 생성하는 데 필요한 기본 요소, 프롬프트, 문서를 제공하는 오픈소스 도구 모음입니다. 이 파일들은 LEGO 모델을 한 번에 하나의 배치 명령으로 설명하는 저수준 어셈블리 언어로, LDView, LeoCAD, Studio 같은 도구에서 대화형 CAD 모델로 렌더링됩니다.

저자는 약 1년 동안 여러 이전 시도 — ldbuilder-ai, py2bricks, py4bricks — 를 거친 후 두 가지 실용적인 결론에 도달했습니다:

기하학 수학에는 최소 저항 경로가 있습니다. 에이전트는 회전과 위치를 직접 출력하는 것보다 수학을 생성하는 Python 코드를 작성하는 데 훨씬 능숙합니다. 따라서 도구는 에이전트가 LDraw 기하학을 직접 다루지 않고 이를 출력하는 Python 코드를 작성하도록 합니다.
에이전트는 모델 자체보다 모델을 생성하는 Python 코드에서 더 잘 학습합니다.

빌드가 끝나면 얻는 것

모델의 LDraw 소스
3D 뷰어, 3D 플레이어, VR 대화형 출력(Meta Quest 3)
메타정보가 Blender 사용자 정의 속성으로 저장된 Blender 편집 가능 glTF(.glb)
전체 채팅 기록과 에이전트의 사고 과정

설정

Git과 Docker가 필요합니다. 웹 앱은 별도 저장소에 있으므로 동일한 태그로 나란히 복제하세요:

git clone --branch v0.6.0 https://github.com/anteloc/ldraw-nova.git
git clone --branch v0.6.0 https://github.com/anteloc/ldraw-nova-docker.git

그런 다음 빌드하고 시작하세요:

cd ldraw-nova-docker
docker compose build
docker compose up -d

첫 빌드는 시간이 걸리며 약 5GB의 디스크 공간이 필요합니다. 앱은 두 개의 포트를 엽니다:

https://localhost:8443 — Quest 3에서 VR에 필요합니다. 자체 서명 인증서이므로 처음에는 브라우저 경고가 표시됩니다.
http://localhost:8765 — 일반 HTTP, 인증서 경고 없음. VR은 여기서 작동하지 않습니다.

같은 네트워크의 다른 장치는 컴퓨터의 IP(예: https://192.168.1.20:8443)를 통해 접속할 수 있습니다. 로그인이 없으므로 신뢰할 수 있는 네트워크에서만 실행하세요. 중지하려면 docker compose down을 사용하세요.

검색 및 재순위

에이전트는 재순위가 포함된 의미 검색을 위해 jev-rerank(같은 저자 제작)를 사용하며, TypeSafe의 Jev System One을 기반으로 합니다. 앱의 설정 섹션에서 TYPESAFE_API_KEY를 설정하면 재순위가 작동합니다. 없으면 에이전트는 전체 텍스트 검색으로 대체되며, README에서는 더 나쁜 모델이 나올 수 있다고 경고합니다.

제공자 및 모델

웹 앱은 에이전트 백엔드로 OpenAI, Claude, OpenRouter를 지원합니다. 저자는 파이프라인을 작동시키는 데 GPT-6 Astra와 Opus 5.5의 공을 돌립니다. 샘플 출력은 anteloc.github.io/index-samples.html에 게시되어 있습니다. 특정 모델을 빌드할 때 에이전트가 무엇을 생각했는지 보려면 텍스트 편집기에서 .mpd 파일을 열고 0 FILE 헤더 아래 첫 줄을 읽으세요.

저장소는 157개의 별, 32개의 커밋, 파일 트리에 CC-BY-SA-4.0으로 표시된 MIT 스타일 라이선스를 가지고 있습니다. 에이전트가 텍스트나 이미지가 아닌 실제로 조립 가능한 출력을 생성하도록 하는 데 관심이 있다면 살펴볼 가치가 있습니다.

📖 전체 소스 읽기: HN AI Agents