shuyu-labs/BigBanana-AI-Director

BigBanana AI Director – 종합적인 AI 단편 영화 / 모션 만화 플랫폼

무엇인가요 – 짧은 이야기나 단일 문장을 완전한 단편 영화나 모션 만화로 변환할 수 있는 웹 기반 작업대입니다. 대규모 언어 모델 기반 텍스트 생성, 이미지 생성, 비디오 간 보간을 통합하여 산업용 '스크립트 → 자산 → 키프레임 → 비디오' 파이프라인을 구현합니다.

핵심 아이디어

• 키프레임 기반 생성 – 시퀀스마다 정확한 시작 프레임과 종료 프레임을 먼저 생성한 후, Veo 보간 모델을 사용해 그 사이의 움직임을 채웁니다. 이로써 카메라 이동을 세밀하게 제어하고 캐릭터 및 소품의 일관성을 보장할 수 있습니다.
• 프로젝트 수준 워크스페이스 – 모든 자산(캐릭터, 장면, 소품, 세계관 노트)은 중앙 허브에 저장되어 에피소드 간 또는 다른 프로젝트 간에 재사용 가능합니다.
• 4단계 제작 프로세스
  1. 스토리 기획 – AI가 플롯 개요나 소설 발췌문을 구조화된 스크립트(캐릭터, 장면, 소품, 촬영 리스트)로 분석합니다. 사용자는 편집하거나 AI가 스토리의 나머지를 자동으로 작성하도록 할 수 있습니다.
  2. 일관성 자산 생성 – 각 캐릭터용 참조 이미지(메이크업샷), 장면 컨셉 아트, 재사용 가능한 소품 이미지를 생성합니다. 자산은 버전 관리되며 배치 처리도 가능합니다.
  3. 샷 워크벤치 – 그리드 UI로 모든 샷을 표시합니다. 각 샷에 대해 시작/종료 키프레임을 업로드하거나 생성하고, 9개의 후보 구성 요소를 미리보기하며 이미지 → 비디오 변환 또는 시작/종료 보간을 실행할 수 있습니다.
  4. 배포 – CutOS 라고 불리는 타임라인 에디터를 통해 샷 순서 변경, 자르기, 필터 추가 후 최종적으로 전체 비디오, 클립 ZIP, 또는 Premiere, DaVinci Resolve와 같은 후속 편집 도구용 원본 자산을 내보낼 수 있습니다.
• 프롬프트 관리 – 스크립트, 캐릭터, 장면, 키프레임, 비디오용 프롬프트 템플릿을 한 페이지에서 확인할 수 있으며, 이력과 롤백 기능이 있어 일관되지 않은 출력을 쉽게 디버깅할 수 있습니다.

기술 스택

• 프론트엔드 UI는 Docker 컨테이너에서 제공되며, 로컬 빌드가 필요 없습니다.
• 백엔드는 AntSK API 플랫폼에 요청을 전달하는 가벼운 오케스트레이터입니다. 여러 대규모 모델 제공업체를 통합합니다:
  • 텍스트: GPT‑5.2 / GPT‑5.1 / Claude 4.6 Sonnet
  • 이미지: Nano Banana Pro, Gpt Image 2
  • 비디오: Sora‑2, Veo‑3.1, Vidu, Seedance 2.0, happyhorse 등
• 모든 데이터(프로젝트 메타데이터, 생성된 자산)는 개인 사용을 위해 브라우저의 로컬 스토리지에 저장됩니다. 대규모 배포 시 Docker Compose 파일을 통해 외부 볼륨을 마운트할 수 있습니다.

실행 방법 (공개 버전)

# 리포지토리 클론 (문서, docker-compose, 공식 이미지 참조만 포함)
git clone https://github.com/shuyu-labs/BigBanana-AI-Director.git
cd BigBanana-AI-Director

# 공식 Docker 이미지 실행
docker‑compose up -d   # 사전 빌드된 이미지를 다운로드하고 포트 3005를 노출하는 컨테이너 생성

# 브라우저에서 http://localhost:3005 열고 화면 안내에 따라 AntSK API 키를 추가하세요

업데이트는 Docker 이미지만을 통해 제공되며, 리포지토리 내 소스 코드는 참고용으로만 유지됩니다. 상용 고객은 별도 라이선스로 전체 소스를 확보할 수 있습니다.

라이선스 – 공개 리포지토리는 CC BY‑NC‑SA 4.0 라이선스로 배포됩니다 (개인적, 비영리 목적 무료, 출처 표시 및 공유 동일 조건 필수). 상용 사용은 저자로부터 유료 라이선스를 받아야 합니다 (문의: anskpro@qq.com).

대상 사용자

• 단편 영상이나 애니메이션 만화를 위한 종단 간 파이프라인을 필요로 하는 독립 크리에이터.
• 시리즈 콘텐츠를 일괄 생성하면서도 시각적 일관성을 유지하고 싶은 소규모 스튜디오.
• 여러 API를 수동으로 연결하지 않고도 AI 기반 스토리텔링을 실험하고 싶은 누구나.

---

크리에이터를 위해, BigBanana가 만들었습니다.