TL;DR

Modly는 사진이나 prompt를 입력받아 로컬 GPU에서 오픈소스 AI 모델로 3D mesh를 생성하는 Desktop app입니다. Windows, Linux, Apple Silicon macOS를 대상으로 하며 모델은 GitHub extension으로 설치하고 workflow 노드를 연결해 생성합니다. Python backend와 TypeScript 앱을 함께 구성해야 하지만, smoothing·decimation과 workspace 저장까지 앱 안에서 처리할 수 있습니다. 실행 중인 앱은 별도 CLI에서 workflow 실행, 모델 조회, 상태 확인, GLB export를 자동화할 수 있어 로컬 3D 생성 파이프라인과 agent 연동에 적합합니다.

핵심 포인트

• Modly는 Windows, Linux, Apple Silicon macOS에서 실행되는 독립형 Desktop app으로, 사진이나 prompt를 3D mesh로 변환하는 도구입니다. 오픈소스 AI 모델을 로컬 GPU에서 실행해 생성 과정을 외부 서비스에 의존하지 않습니다. TypeScript 기반 Electron 앱과 Python backend를 함께 설정해야 하므로 단순 웹 도구보다 로컬 개발 환경 구성이 중요합니다.
• 모델 기능은 외부 GitHub extension으로 분리되어 Hunyuan3D 2 Mini 계열, TripoSG, Trellis2 GGUF를 추가할 수 있습니다. 각 extension은 manifest.json과 유형별 runtime entry 파일을 포함하며, 앱의 Models 페이지에서 HTTPS 저장소 URL을 입력해 설치합니다. 모델 또는 variant를 내려받은 뒤 Image → Generate Mesh → Add to Scene workflow를 연결해 3D 생성 과정을 구성합니다.
• Modly는 이미지 입력부터 mesh 생성과 Scene 추가까지 연결하는 workflow 구조를 사용합니다. 실행 전에 노드 연결을 검증하고 잘못된 graph는 현재 mesh 화면을 유지한 채 inline 또는 toast 경고를 띄웁니다. 가져온 mesh에는 앱 안에서 smoothing과 decimation을 적용할 수 있으며, 최적화 결과는 workspace에 다시 기록됩니다.
• 실행 중인 Desktop app은 stdlib-only CLI로 자동화할 수 있어 agent와 script가 UI 없이 health, model, workflow-run, capability, process-run 명령을 호출합니다. `generate --image ./input.png --output ./export.glb`는 이미지 기반 workflow를 시작하고 실행 상태를 polling한 뒤 최종 mesh를 export하며, 결과 JSON에 상태 조회와 취소용 recovery metadata를 포함합니다. 표준 개발 환경은 Node.js 의존성, Python virtual environment, FastAPI backend 구성이며 `npm run dev`, `npm test`, TypeScript 검사와 build 명령으로 확인합니다.