sorker/ai-shotlive

AI ShotLive Director – 하나의 플랫폼에서 완성하는 AI 단편 드라마 / 모션 코믹 제작

무엇인가요

• 소설이나 스토리 개요를 전체 길이의 단편 영상 또는 만화로 전환할 수 있는 웹(또는 Electron을 통한 데스크톱) 애플리케이션입니다. 작업 흐름은 완전히 산업화되어 있습니다: 소설 → 스크립트 → 스토리보드 → 자산 → 키프레임 → 최종 영상.
• 자체적으로 AI 모델을 호스팅하지 않습니다. 대신 텍스트, 이미지, 영상, 오디오 API(OpenAI, Anthropic, Google Gemini, AntSK 등)를 얇은 어댑터 계층을 통해 외부에서 호출합니다.

핵심 아이디어

• 키프레임 기반 생성 – 각 장면에 대해 시작 프레임과 끝 프레임을 먼저 생성한 후, 영상 모델을 사용해 중간 프레임을 보간합니다. 이 방식은 시각적 일관성을 유지하면서 비용이 많이 드는 영상 생성량을 줄입니다.
• 자산 제약 – 캐릭터 ‘메이크업’ 이미지와 장면 개념 예술은 모든 생성 프레임의 참조로 사용되어, 장면 간 동일한 캐릭터가 일관되게 보이도록 합니다.
• 다중 모델 지원 – 텍스트, 이미지, 영상, 오디오에 대해 다양한 제공자를 혼합 사용할 수 있으며, 단순히 Model Config 페이지에서 API 키만 바꾸면 모델을 교체할 수 있습니다.

주요 모듈

단계	기능
01 – 소설 및 스크립트	.txt 형식의 소설 업로드, 챕터 자동 파싱, 생성할 에피소드 스크립트로 선택된 챕터 지정; 또는 스토리 개요를 직접 붙여넣기. AI는 장면 분해, 대사, 시각적 프롬프트를 생성합니다.
02 – 자산 및 캐스팅	캐릭터 참조 이미지(의류 변형 포함) 및 장면 개념 예술 생성; 사용자 정의 소품 업로드.
03 – 디렉터 워크벤치	그리드 기반 스토리보드 편집기; 첫 번째/마지막 키프레임 편집; 각 장면에 대한 9개 그리드 미리보기; 현재 캐릭터 및 장면 이미지를 재사용하는 맥락 인식 생성; 이미지 → 영상(I2V) 및 키프레임 보간 모드 모두 지원.
04 – 내보내기 및 편집	타임라인 미리보기, 멀티트랙 영상 편집기(영상, 오디오, 자막, 이미지), AI 생성 자막 및 TTS 오디오, 고해상도 프레임 또는 MP4로 내보내기.
계정 및 데이터	사용자별 격리, 비밀번호 변경, MySQL/SQLite 데이터와 data/ 미디어 폴더를 포함한 ZIP 파일을 통한 프로젝트/자산 완전 백업 및 복원.

기술 스택

• 프론트엔드: React 19 + Vite 6, Tailwind CSS 4, Radix UI, Framer Motion.
• 백엔드: Express.js, JWT 인증, MySQL 8(또는 로컬 모드에서 SQLite).
• 데스크톱 클라이언트: Electron 33 + better‑sqlite3; macOS(Intel 및 Apple-Silicon) 및 Windows용 빌드 지원.
• AI 통합: 어댑터 계층(services/adapters)을 통해 채팅, 이미지, 영상, 오디오 생성에 대해 지원되는 모든 제공자에 대한 호출을 표준화합니다.
• 배포: Docker Compose(선택적 외부 MySQL 포함) 또는 로컬 개발용 간단한 npm run dev.

크리에이터의 일반적인 워크플로우

1. 로그인 (기본 관리자/admin123 또는 회원가입).
2. 모델 구성 – 사용할 텍스트, 이미지, 영상, 오디오 서비스의 API 키 추가.
3. 프로젝트 생성 → 소설 업로드 또는 스토리 붙여넣기.
4. 스크립트 생성 – AI가 선택한 챕터를 장면 설명이 포함된 시나리오로 재작성.
5. 자산 생성 – 캐릭터 룩북 및 장면 개념 예술 생성; 사용자 정의 소품 업로드.
6. 스토리보드 작성 – 장면 편집, 첫 번째/마지막 키프레임 설정, 9그리드 보기 선택, 영상 모델이 클립 렌더링하도록 함.
7. 편집 및 다듬기 – 내장된 멀티트랙 편집기를 사용해 AI 생성 자막, TTS 음성 녹음, 추가 미디어 추가.
8. 내보내기 – 최종 영상 또는 개별 고해상도 프레임 다운로드.

시작하기

# 복제 및 설치
git clone https://github.com/sorker/ai-shotlive.git
cd ai-shotlive
npm install
cp .env.example .env   # DB 및 JWT 설정 수정

# 로컬 SQLite 모드 (외부 DB 필요 없음)
npm run build:local
npm run start:local   # http://localhost:3001

생산 환경에서는 Docker 파일(docker-compose.yaml 또는 docker-compose.mysql.yaml)을 사용할 수 있습니다. Electron 클라이언트는 npm run build:electron으로 빌드하여 .dmg 또는 .exe로 배포할 수 있습니다.

누가 사용할 수 있나요

• 비디오 편집 소프트웨어를 배우지 않고도 애니메이션 단편 또는 모션 코믹을 프로토타이핑하고 싶은 독립 크리에이터.
• 자체 모델 제공자를 사용해 맞춤형으로 조정 가능한 빠른 ‘스크립트 → 영상’ 파이프라인을 찾는 소규모 스튜디오.
• AI 보조 스토리텔링이나 키프레임 기반 영상 생성을 교육용으로 보여주고 싶은 교육자.

라이선스

• Creative Commons BY‑NC‑SA 4.0 – 개인 및 비상업적 사용에 무료이며, 파생작품은 동일한 라이선스 하에 공유해야 합니다.

---

위 모든 정보는 리포지토리의 README에서 직접 인용되었으며, 추가 기능은 추정하지 않았습니다.