GTKottman/mortiflix-oss

Mortiflix – 로컬에서 실행하는 AI 기반 모션 디자인 스튜디오

개요
Mortiflix는 단일 크리에이터가 Claude가 생성한 콘텐츠를 단계별로 오케스트레이션하여 짧은 비디오(설명 동영상, 소셜 숏, 로고 스팅)를 제작할 수 있게 하는 명령줄/웹 기반 애플리케이션입니다. 비디오 제작을 스튜디오 파이프라인(브리프 → 스크립트 → 스타일 프레임 → 애니매틱 → 최종본)으로 취급하며, 각 단계 후에 일시 중지하여 사용자가 검토, 메모, 승인을 한 후 다음 Claude 세션이 실행됩니다.

작동 방식

• 백엔드 – Mortiflix는 로그인된 Claude Code 세션 또는 Anthropic API(자체 API 키)를 통해 Claude와 통신할 수 있습니다. "demo" 백엔드는 비용이 들지 않는 스크립트된 플레이스홀더 실행을 제공합니다.
• 세션 게이팅 – 각 단계는 자체 Claude 세션에서 실행됩니다. 모델이 산출물을 완료하면 중지하고 핸드오프를 작성합니다. 사용자가 이를 검토하고 메모를 추가하면 새 세션이 지속된 저널에서 이어받습니다. 즉, 시스템은 토큰을 소비하지 않고 몇 시간 또는 며칠 동안 유휴 상태로 있을 수 있습니다.
• 파이프라인 – 파이프라인은 JSON 설명(pipeline.json)과 Markdown 크래프트 가이드로 구성됩니다. 파이프라인은 단계, 통과해야 하는 검사, 검토 수행 방법을 정의합니다. 저장소에는 세 가지 내장 파이프라인(explainer, social-short, logo-sting)이 포함되어 있으며, 사용자는 이를 복사 편집하여 새 파이프라인을 만들 수 있습니다.
• 프로덕션 스택 – 비디오 렌더링은 Remotion(React 기반 비디오 라이브러리)으로 수행되며 ffmpeg 검사(형식, 프리즈 프레임, 음량 등)로 검증됩니다.
• 내레이션 – 선택적 음성 해설은 ElevenLabs, GPU에서 실행되는 로컬 Qwen-3 TTS 모델 또는 사용자 녹음으로 생성할 수 있습니다. 음성-텍스트 검증을 통해 오디오가 스크립트와 일치하는지 확인합니다.
• 음악 – 오리지널 스코어는 Strudel(선언적 음악 언어)로 작곡되며 MIDI 플러스 오디오 스템으로 내보내집니다.
• 에셋 및 3D – 에셋은 브라우저 하네스 도구를 사용하여 사용자 제공 웹사이트에서 가져올 수 있으며, 3D 장면은 사용자 정의 "Nova FX" 입자 엔진이 있는 Blender에서 구축됩니다.

시작하기

1. Node 20+ 및 ffmpeg를 설치합니다.
2. 저장소를 클론하고 npm install 및 npm link(또는 node bin/mortiflix)를 실행합니다.
3. mortiflix init은 ~/Mortiflix 스튜디오 폴더를 만들고 Claude/Anthropic 키(및 선택적으로 ElevenLabs)를 묻습니다.
4. mortiflix demo를 실행하여 플레이스홀더 에셋으로 전체 실행을 확인합니다(Claude 불필요).
5. 실제 프로젝트의 경우 터미널 워크플로(mortiflix new …, mortiflix run, mortiflix review)를 사용하거나 mortiflix serve로 웹 UI를 시작하고 브라우저에서 상호 작용합니다.

중요성

• 비용 효율성 – 시스템은 승인할 항목이 있을 때만 Claude를 호출하므로 토큰 사용량은 실제로 필요한 창의적 단계로 제한됩니다.
• 사용자 참여 – "원프롬프트 비디오 생성기"와 달리 Mortiflix는 세밀한 제어를 제공하여 정확성과 브랜딩이 중요한 전문가급 설명 동영상에 적합합니다.
• 오픈 소스 및 확장 가능 – 파이프라인은 단순한 JSON 파일입니다. 누구나 새 스타일, 뮤직 비디오 파이프라인 또는 사용자 정의 검사를 추가할 수 있습니다. AGPL-3.0 라이선스는 도구를 서비스로 실행하는 경우 수정 사항을 공유해야 함을 보장합니다.

대상 사용자

• 데이터를 호스팅 서비스에 넘기지 않고 AI 지원 비디오 제작을 원하는 개인 크리에이터, 교육자 또는 소규모 팀.
• AI 기반 모션 디자인 파이프라인을 구축하거나 확장하는 데 관심이 있는 개발자.

제한 사항

• 현재 Linux에서 가장 잘 지원됩니다. Windows 지원은 2026년 10월로 예정되어 있으며 macOS는 테스트되지 않았습니다.
• 유료 Claude 플랜 또는 Anthropic API 사용이 필요합니다. demo 백엔드만 무료 옵션입니다.
• 무거운 단계(렌더링, 3D, 음악 합성)는 여전히 강력한 로컬 머신(로컬 TTS용 GPU, 3D용 Blender)이 필요합니다.

---

위의 모든 세부 사항은 저장소의 README에서 직접 가져온 것입니다.