← 보드로 돌아가기

lightningpixel/modly

Desktop app to generate 3D models from images using local AI — runs entirely on your GPU

GitHub에서 열기 ↗ 3dai-localai-toolsdesktop-appmodlyopen-sourceself-hosted
4,253
GitHub 스타
459
포크
TypeScript
언어
NOASSERTION
라이선스
2026.07.09
최근 푸시
2026.05.10
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
로컬 AI 3D 생성 데스크톱 앱으로, 확장성과 CLI 자동화가 뛰어나 개인 프로젝트나 연구에 적합합니다. 다만 초기 설정이 다소 까다로울 수 있습니다.

강점

  • 로컬 GPU에서 완전히 실행되어 데이터 프라이버시를 보장하고 인터넷 연결이 필요 없음
  • 확장 시스템을 통해 다양한 AI 모델(Hunyuan3D, TripoSG, Trellis2 등)을 플러그인 방식으로 추가 가능
  • CLI를 제공하여 에이전트 및 스크립트에서 UI 없이 자동화 가능

약점

  • macOS는 Apple Silicon만 지원하여 Intel Mac 사용자는 사용 불가
  • Python 백엔드와 Node.js 프론트엔드 모두 설정해야 하므로 초기 설치가 다소 복잡함
  • 확장 모델 다운로드가 필요하며, 모델 크기가 커서 디스크 공간과 시간이 많이 소요될 수 있음

주의사항

  • 설치 시 Python 가상 환경과 npm 종속성을 모두 설정해야 하며, GPU 드라이버 및 CUDA 등 추가 요구사항이 있을 수 있음
  • 확장 시스템은 GitHub 저장소 URL을 통해 설치하므로 신뢰할 수 있는 확장만 설치해야 함
  • MIT 라이선스이지만 포크 시 원본 프로젝트 표시가 의무이므로 라이선스 조건을 준수해야 함

시작 가이드

  • 저장소를 클론하고 README의 설치 단계에 따라 npm install 및 Python 가상 환경 설정을 진행
  • 공식 확장 중 하나를 설치하여 이미지-3D 생성 테스트
  • CLI를 사용하여 generate 명령어로 배치 처리 자동화 시도

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

<p align="center"> <img src="resources/icons/icon.png" width="96" alt="Modly 로고" /> </p>

Modly

로컬, 오픈 소스, AI 기반 이미지-3D 메시 생성. 사진을 오픈 소스 AI 모델을 사용하여 3D 모델로 변환하며, 모든 작업이 GPU에서 로컬로 실행됩니다. Modly는 Windows, Linux, Apple Silicon macOS용 데스크톱 애플리케이션입니다.

Lightning Pixel 제작

<p align="center"> <img src="docs/app-screenshot.png" alt="Modly 스크린샷" /> </p>

다운로드

릴리스 페이지에서 Windows, Linux, Apple Silicon macOS용 최신 설치 프로그램을 다운로드하세요.

또는 저장소를 클론하고 설치 없이 앱을 직접 실행할 수 있습니다:

# Windows
launch.bat

# Linux / macOS./launcher.sh

시작하기

1. JS 종속성 설치

npm install

2. Python 백엔드 설정

cd api
python -m venv.venv.venv\Scripts\activate     # Windows
source.venv/bin/activate  # Linux / macOS
pip install -r requirements.txt

3. 개발 모드로 실행

npm run dev

4. 테스트

npm test./node_modules/.bin/tsc --noEmit -p tsconfig.node.json
npm run build

플랫폼 참고 사항

  • macOS 지원은 Apple Silicon 전용입니다.
  • macOS는 네이티브 윈도우 컨트롤을 사용합니다. Windows와 Linux는 기존 사용자 정의 컨트롤을 유지합니다.
  • 상단 바에는 메인 프로세스에서 가져온 실시간 RAM 표시기가 포함됩니다.
  • 워크플로 연결은 실행 전에 검증됩니다. 유효하지 않은 그래프는 그대로 유지되며, 현재 메시 뷰를 삭제하는 대신 인라인/토스트 경고를 표시합니다.
  • Apple Silicon macOS는 npm run package:mac으로 패키징합니다.
  • 가져온 메시는 앱 내에서 스무딩 및 디시메이션할 수 있습니다. 최적화된 결과는 워크스페이스에 다시 기록됩니다.

확장 시스템

Modly는 외부 모델 및 프로세스 확장을 지원합니다. 각 확장은 manifest.json과 해당 유형에 필요한 런타임 진입 파일을 포함하는 GitHub 저장소입니다.

공식 확장

확장 모델 URL
modly-hunyuan3d-mini-extension Hunyuan3D 2 Mini https://github.com/lightningpixel/modly-hunyuan3d-mini-extension
modly-hunyuan3d-mini-turbo-extension Hunyuan3D 2 Mini Turbo https://github.com/lightningpixel/modly-hunyuan3d-mini-turbo-extension
modly-hunyuan3d-mini-fast-extension Hunyuan3D 2 Mini Fast https://github.com/lightningpixel/modly-hunyuan3d-mini-fast-extension
modly-triposg-extension TripoSG https://github.com/lightningpixel/modly-triposg-extension
modly-trellis2-gguf-extension Trellis2 GGUF https://github.com/lightningpixel/modly-trellis2-gguf-extension

확장 설치 방법

1. 모델 페이지로 이동하여 GitHub에서 설치를 클릭합니다.

!GitHub에서 설치

2. 확장 저장소의 HTTPS URL을 입력하고 확인합니다.

!확장 URL 입력

3. 확장이 모델 노드를 노출하는 경우, 모델 또는 그 변형 중 하나를 다운로드합니다. 프로세스 확장은 설치 및 설정이 완료되면 바로 사용할 수 있습니다.

!모델 설치

Modly CLI

에이전트와 스크립트는 UI 없이 실행 중인 Modly 데스크톱 앱을 stdlib 전용 CLI를 통해 호출할 수 있습니다. CLI는 Modly의 표준 자동화 개념에 대한 얇은 헬퍼이며, 최종 머신 판독 가능 JSON을 stdout으로 출력합니다:

python tools/modly-cli/agent.py health
python tools/modly-cli/agent.py model list
python tools/modly-cli/agent.py workflow-run status <run_id>
python tools/modly-cli/agent.py generate --image./input.png --output./export.glb

표준 명령어는 health, model, workflow-run, capability, process-run입니다. 사용자 친화적인 generate 명령어는 POST /workflow-runs/from-image를 시작하고, 반환된 실행을 폴링하며, 요청 시 최종 메시를 내보내고, JSON 응답에 workflow-run status... 및 workflow-run cancel...과 같은 복구 메타데이터를 포함합니다.

호환성 및 헬퍼 표면은 의도적으로 분리되어 있습니다: legacy는 이전 /generate/* 작업 엔드포인트를 래핑하고, dev serve-api / dev ensure-server는 FastAPI 백엔드만 시작하며 Electron/데스크톱 브리지 준비 상태를 증명하지 않으며, experimental comfy-image / experimental generate-from-workflow는 표준 Modly 에이전트 계약이 아닌 외부 ComfyUI 오케스트레이션 헬퍼입니다. status, export, batch와 같은 숨겨진 헬퍼 별칭은 스크립트에서 구문 분석 가능하지만 표준 루트 명령어로 제시되지 않습니다.

experimental generate-from-workflow --workflow <name> --output <path>는 --output을 최종 아티팩트 위치로 처리합니다. ComfyUI 워크플로가 다운로드 가능한 3D 자산을 생성하면 CLI가 직접 다운로드합니다. 이미지 전용 워크플로는 Modly 이미지-3D 생성을 통한 호환성 경로로 남아 있습니다.

자세한 내용은 tools/modly-cli/SKILL.md를 참조하세요.

커뮤니티

Discord 서버에 참여하여 최신 뉴스, 버그 신고, 피드백 공유를 확인하세요.

스폰서

<p align="center"> Modly를 믿고 로컬 AI 3D 생성을 더 접근하기 쉽게 만드는 데 도움을 주신 초기 스폰서분들께 감사드립니다. </p>

<p align="center"> <kbd> <img src="https://images.weserv.nl/?url=github.com/DrHepa.png&w=96&h=96&fit=cover&mask=circle" width="40" height="40" alt="DrHepa" /> <br /> <sub><a href="https://github.com/DrHepa">DrHepa</a></sub> </kbd> &nbsp;&nbsp; <kbd> <img src="https://images.weserv.nl/?url=github.com/benjapenjamin.png&w=96&h=96&fit=cover&mask=circle" width="40" height="40" alt="benjapenjamin" /> <br /> <sub><a href="https://github.com/benjapenjamin">benjapenjamin</a></sub> </kbd> &nbsp;&nbsp; <kbd> <img src="https://images.weserv.nl/?url=github.com/iammojogo-sudo.png&w=96&h=96&fit=cover&mask=circle" width="40" height="40" alt="iammojogo-sudo" /> <br /> <sub><a href="https://github.com/iammojogo-sudo">iammojogo-sudo</a></sub> </kbd> </p>

라이선스

MIT 라이선스 — 자세한 내용은 LICENSE를 참조하세요.

이 프로젝트를 포크하여 자체 앱을 빌드하는 경우, 원본 프로젝트와 제작자를 반드시 표시해야 합니다:

Modly 기반, Lightning Pixel 제작

이는 MIT 라이선스 저작자 표시 조항의 요구사항입니다. 앱의 UI 또는 문서에 이 표시를 유지하세요.

원본 저장소: lightningpixel/modly

라이선스: NOASSERTION

게재 제외를 원하시면 삭제 요청을 보내주세요.