Lightricks/LTX-Desktop

LTX Desktop – 무엇인가요

LTX Desktop는 LTX 브랜드의 생성 모델을 사용하여 동영상(및 이미지)을 생성하고 편집할 수 있는 오픈소스 데스크톱 애플리케이션입니다. 강력한 Windows/Linux NVIDIA GPU 또는 Apple Silicon 맥에서 로컬로 실행되며, 하드웨어가 부족할 경우 유료 클라우드 API로 자동 전환됩니다.

핵심 기능

기능	작동 방식
텍스트에서 동영상	프롬프트를 입력하면 로컬 LTX 2.5 Fast(기본) 또는 LTX 2.3 Fast 모델이 동영상을 생성합니다.
이미지에서 동영상 / 오디오에서 동영상	동일한 모델은 이미지 또는 오디오 클립을 추가 조건으로 수용합니다.
동영상 편집 (리테이크 / 연장)	오래된 LTX 2.3 Fast 모델만 로컬에서 "리테이크" 편집을 지원하며, 최신 LTX 2.5 Pro 버전은 클라우드 API를 통해 처리합니다.
텍스트에서 이미지 및 이미지에서 이미지	동일한 백엔드를 사용하여 통합된 이미지 생성/편집 기능이 포함되어 있습니다.
LoRA 지원	내장 라이브러리 또는 자체 `.safetensors` 파일에서 LoRA 어댑터(스타일/주제 조정)를 로드할 수 있습니다 – 로컬 동영상 생성에만 적용됩니다.
프롬프트 강화	로컬 모듈 또는 Gemini API를 통해 카탈로그 인식 기반의 프롬프트 재작성으로 프롬프트를 개선합니다.
동영상 편집 UI	타임라인 기반 편집기로 생성된 클립을 조합하고 자르며, 갭을 채울 수 있습니다.

로컬 vs. API 모드

플랫폼	로컬 생성이 가능한 경우	API 전용이 가능한 경우
Windows + CUDA GPU (≥16 GB VRAM)	모델 가중치를 다운로드하고 GPU에서 실행합니다.	GPU 부족, VRAM < 16 GB, 또는 드라이버 미확인 → LTX API 키 필요.
Linux + CUDA GPU (≥16 GB VRAM)	Windows와 동일합니다.	동일한 폴백.
macOS Apple Silicon (≥15 GB 사용 가능 RAM)	Apple의 MPS 백엔드에서 실행됩니다.	사용 가능한 RAM 부족 또는 Intel 맥 → API 전용.

API 전용 모드에서는 여전히 동영상을 생성할 수 있지만, 클라우드 서비스가 제공하는 해상도/길이에 제한되며 Fast 또는 Pro 요금제에 대한 요금이 발생합니다.

시작하기

리포지토리의 Releases 페이지에서 설치 프로그램을 다운로드합니다.
설치 프로그램을 실행합니다 – Electron 기반 UI와 Python FastAPI 백엔드가 생성됩니다.
처음 실행 시, 게이트된 2.5 모델 가중치의 라이선스를 수락하기 위해 Hugging Face에 로그인해야 할 수 있습니다.
Settings → API에서 무료 LTX API 키(클라우드 텍스트 인코딩 및 선택적 클라우드 생성용)를 설정합니다.
UI에서 Local 또는 API 모드를 선택합니다. 앱은 자동으로 하드웨어와 사용 가능한 RAM을 감지합니다.

모든 앱 데이터(설정, 다운로드된 모델, 로그)는 OS별 표준 데이터 폴더에 저장됩니다:

Windows: %LOCALAPPDATA%\LTXDesktop\
macOS: ~/Library/Application Support/LTXDesktop/
Linux: ~/.local/share/LTXDesktop/

개발 및 기여

리포지토리는 세 가지 계층으로 나뉩니다:

Renderer – React + TypeScript UI (frontend/).
Electron – 네이티브 창, 파일 대화상자, 프로세스 관리 (electron/).
Backend – GPU 및 외부 API와 통신하는 Python FastAPI 서버 (backend/).

기여자용 빠른 시작:

# Node, uv, Python 3.13+, Git 설치
pnpm setup:dev   # 종속성 설치, 가상 환경 생성, UI 빌드
pnpm dev         # Electron + 백엔드를 개발 모드로 실행

디버깅, 타입 체크, 백엔드 테스트, 성능 검증용 추가 스크립트도 존재합니다.

라이선스 및 프라이버시

코드 – Apache-2.0.
모델 가중치 – Hugging Face에서 별도로 다운로드되며, 각각 고유의 라이선스를 가집니다.
테레메트리 – 선택적 익명 사용 통계(앱 버전, 플랫폼, 랜덤 ID). Settings → Anonymous Analytics에서 비활성화 가능.

누구에게 유용할까?

클라우드에 데이터를 전송하지 않고도 데스크톱 전용 워크플로우로 빠르게 동영상 프로토타이핑이 필요한 크리에이터.
동영상 확산 모델에서 LoRA 어댑터를 실험하는 연구자.
텍스트에서 동영상, 이미지에서 동영상, 기본 동영상 편집을 단일 UI로 사용하고, 하드웨어가 부족할 경우 유료 API로 폴백하고 싶은 팀.

결론: LTX Desktop은 고성능 GPU/Apple Silicon에서 완전히 로컬로 생성할 수 있는 현대적인 동영상 확산 파이프라인을 사용자 친화적인 Electron 앱으로 통합하여 제공하며, 성능이 낮은 기기에는 클라우드 폴백을 제공합니다. 진정한, 활발히 유지 관리되는 AI 중심 프로젝트입니다.