주요 특징

• 모델을 앱에 내장하지 않고 확장으로 분리한 구조가 이 프로젝트의 설계 핵심입니다. 확장 하나는 `manifest.json`과 타입별 런타임 진입 파일을 담은 GitHub 저장소이고, Models 페이지에서 "Install from GitHub"를 눌러 HTTPS URL을 넣으면 설치됩니다. 공식 확장으로는 Hunyuan3D 2 Mini, Hunyuan3D 2 Mini Turbo, Hunyuan3D 2 Mini Fast, TripoSG, Trellis2 GGUF 다섯 가지가 각각 별도 저장소로 제공되며, 모델 노드를 노출하는 확장은 설치 후 본체나 변형 가중치를 골라 내려받는 단계를 거칩니다. 모델 실행 부분과 앱 본체가 분리돼 있어 새 3D 생성 모델이 나와도 앱 릴리스를 기다리지 않고 확장만 추가하면 됩니다.
• 생성 과정이 단일 버튼이 아니라 노드를 잇는 워크플로로 되어 있습니다. Workflows 탭에서 Image → Generate Mesh → Add to Scene 같은 그래프를 만들고 각 단계가 실제로 연결됐는지 확인한 뒤 Generate 탭에서 실행하는 흐름이며, 워크플로 배선은 실행 전에 검증됩니다. 유효하지 않은 그래프는 그 자리에 남겨 두고 인라인 경고와 토스트로 알릴 뿐 현재 보고 있던 메시 뷰를 날리지 않습니다. Settings/Logs/Errors 패널에서 실패 원인을 확인할 수 있고, 불러온 메시는 앱 안에서 스무딩과 데시메이션으로 다듬어 워크스페이스에 다시 써 넣을 수 있습니다.
• 에이전트와 스크립트가 UI를 거치지 않고 호출할 수 있는 CLI가 함께 들어 있습니다. `tools/modly-cli/agent.py`는 표준 라이브러리만 쓰고 최종 결과를 기계가 읽을 수 있는 JSON으로 stdout에 남기며, 정규 명령은 `health`, `model`, `workflow-run`, `capability`, `process-run` 다섯 가지입니다. 편의 명령 `generate --image ./input.png --output ./export.glb`는 `POST /workflow-runs/from-image`를 시작해 반환된 run을 폴링하고 요청 시 최종 메시를 내보내며, 응답 JSON에 `workflow-run status ...`와 `workflow-run cancel ...` 같은 복구 메타데이터를 함께 담습니다. 구 `/generate/*` 잡 엔드포인트를 감싸는 `legacy`, FastAPI 백엔드만 띄우는 `dev serve-api`, 외부 ComfyUI를 오케스트레이션하는 `experimental` 계열은 정규 계약과 의도적으로 분리해 표시합니다.
• 설치와 실행 경로가 두 갈래입니다. Releases 페이지에서 Windows·Linux·애플 실리콘 macOS용 설치 파일을 받는 방법과, 저장소를 클론해 `launch.bat`(Windows) 또는 `launch.sh`(Linux/macOS)로 설치 없이 바로 띄우는 방법입니다. 개발 모드는 `npm install`로 JS 의존성을 깔고 `api/` 아래에 Python 가상환경을 만들어 `requirements.txt`를 설치한 뒤 `npm run dev`로 돌리는 Electron + FastAPI 구성이며, macOS 패키징은 `npm run package:mac`입니다. 상단 바에 메인 프로세스에서 가져온 실시간 RAM 표시가 있어 모델을 올렸을 때의 메모리 여유를 확인할 수 있습니다.
• 제약도 분명합니다. macOS는 애플 실리콘만 대상으로 하고 인텔 맥은 지원하지 않으며, 창 컨트롤도 macOS는 네이티브·Windows와 Linux는 자체 컨트롤로 갈립니다. 모델이 전부 로컬에서 도는 만큼 VRAM이 실질적인 하한선이 되어 Mini 계열 기준 8GB 이상 GPU가 권장됩니다. 라이선스는 MIT지만 저장소를 포크해 자체 앱을 만들 경우 원 프로젝트와 제작자(Lightning Pixel)를 앱 UI나 문서에 눈에 띄게 표기하라는 조건을 README에 명시해 뒀습니다. 2026년 3월에 만들어진 비교적 새 저장소이면서 8월 하순까지 커밋이 이어지고 있고, Discord 커뮤니티로 버그 리포트와 피드백을 받습니다.