DramaClaw는 원고나 대본을 넣으면 캐릭터 추출, 에피소드 기획, 스크립트 생성, 스토리보드와 첫 프레임 생성, 보이스오버, 영상 합성, 자막 내보내기까지 이어 주는 AIGC 비디오 제작 엔진이다.
단일 텍스트-투-비디오 모델이 아니라, 드라마 제작 공정을 단계별 작업 라인으로 쪼갠다. 짧은 드라마, 광고, 이커머스 제품 영상, 오토메 게임 같은 반복형 시각 콘텐츠를 자체 인프라에서 만들고 싶은 크리에이터·스튜디오·크리에이티브 엔지니어를 겨냥한다. 2026년 7월 13일 기준 GitHub 스타는 약 1.2k다.
제작 파이프라인
| 단계 | 역할 |
|---|---|
| 원고 파싱 | 원고를 캐릭터, 관계, 타임라인으로 구조화 |
| 에피소드 기획 | 챕터 분할, 비트 설계, 장기 서사 흐름 구성 |
| 스크립트 생성 | adaptive, literal, staged 모드와 리뷰·수정 루프 |
| 스토리보드 | 비트 기반 스타일 이미지, 그리드 분할, 이미지 후보 풀 |
| 음성 합성 | 감정 인식 보이스오버, 여러 제공자 전환 |
| 영상 합성 | 에피소드 조립, 영상·자막·전체 에셋 팩 내보내기 |
차별점
DramaClaw의 강점은 “더 긴 영상 생성”보다 제작 운영 구조에 있다. 캐릭터, 장면, 소품, 음성 같은 에셋 라이브러리를 중심에 두고, 에피소드마다 일관된 인물 정체성과 장면 구성을 유지하려 한다.
| 접근 | 한계 | DramaClaw 방식 |
|---|---|---|
| 단일 영상 생성 모델 | 샷 간 캐릭터·공간 일관성 유지가 어렵다 | 에셋 라이브러리와 스토리 그래프로 반복 사용 |
| 노드형 범용 워크플로 | 드라마 비트, 에피소드 호흡, 캐릭터 연속성을 모른다 | 드라마 제작 도메인에 맞춘 단계와 검수 루프 |
| 클라우드 블랙박스 툴 | 원고와 IP를 외부 서비스에 맡겨야 한다 | 자체 서버와 OpenAI 호환 게이트웨이 사용 |
주요 기능
- Asset Library: 캐릭터, 장면, 소품, 음성을 통합 관리하고 에피소드별 변형을 만든다.
- Freezone: 노드 기반 무한 캔버스에서 이미지·영상·오디오 후보를 탐색한 뒤 메인 라인으로 승격한다.
- Director World / 3GS: 가상 세트의 공간 구조, 카메라, 캐릭터 블로킹을 고정해 샷 일관성을 높인다.
- Xia Director: 프로젝트 진행 상황을 확인하고 누락된 산출물을 점검하는 대화형 제작 보조 에이전트다.
- Task Center: 백그라운드 생성 작업의 상태, 로그, 취소, 재시도, 체크포인트 재개를 관리한다.
설치와 실행
Docker 실행이 권장 경로다.
git clone https://github.com/dramaclaw/dramaclaw.git
cd dramaclaw
cp .env.example .env
docker compose up -d --build웹 UI는 http://localhost:8080, REST API는 http://localhost:8780에서 열린다. 공식 게이트웨이 키를 쓰거나, NEWAPI_BASE_URL로 자체 OpenAI 호환 게이트웨이를 연결할 수 있다.
릴리스 이미지를 바로 쓰는 경로도 제공된다.
curl -LO https://raw.githubusercontent.com/dramaclaw/dramaclaw/main/docker-compose.release.yml
docker compose -f docker-compose.release.yml up -d시스템 요구사항
표준 파이프라인은 모델 추론을 원격 OpenAI 호환 게이트웨이로 보내므로 로컬 GPU가 필수는 아니다. 권장 기본값은 2 vCPU, 4GB RAM, Docker Compose, 몇 GB의 디스크 공간이다. 선택 기능인 world extra는 CUDA GPU가 필요할 수 있다.
누가 쓰면 좋은가
- 쇼트폼 드라마 제작팀: 원고를 다수 에피소드와 샷으로 반복 변환해야 할 때
- 광고·이커머스 콘텐츠 팀: 제품 영상 템플릿을 자체 파이프라인으로 운영하고 싶을 때
- AI 비디오 엔지니어: OpenMontage처럼 에이전틱 영상 제작 파이프라인을 직접 확장하고 싶을 때
라이선스
저장소는 source-available 형태이며 GitHub 메타데이터 기준 SPDX 라이선스가 명확히 단일 오픈소스 라이선스로 판별되지 않는다. 실제 사용 전 LICENSES/Elastic-2.0.txt와 프로젝트 약관을 확인해야 한다.
관련 문서
- openmontage — AI 코딩 어시스턴트를 영상 제작 스튜디오로 바꾸는 에이전틱 비디오 시스템
- video-use — AI 에이전트로 영상을 편집하는 오픈소스 도구
- seedance-2 — 텍스트·이미지·영상·오디오를 동시에 입력하는 ByteDance 영상 생성 모델
- joyai-echo — 장문 오디오-비디오 생성을 위한 JD 오픈 모델
참고 자료
- dramaclaw/dramaclaw — GitHub 공식 저장소