Toonflow Docker로 AI 숏드라마 제작 흐름 묶기

AI 숏드라마 제작은 장면 한 개를 만드는 일보다 대본, 캐릭터, 컷, 영상 조각을 한 프로젝트에서 잃지 않는 일이 더 어렵습니다. Toonflow는 이 흐름을 작업 화면 하나에 모으는 오픈소스 데스크톱 도구입니다.

개요

Toonflow 설치 뒤에는 텍스트에서 대본을 만들고, 캐릭터와 장면 자료를 정리한 다음, 스토리보드와 영상 노드를 이어서 관리할 수 있습니다. README는 무한 캔버스 작업 화면, ScriptAgent·ProductionAgent, 파일로 분리한 Skill 설정을 핵심 구성으로 설명합니다.

저는 Claude나 Codex CLI를 대본 초안과 프롬프트 정리에 두고, 컷과 영상 자산의 작업 상태까지 계속 이어야 할 때 Toonflow를 검토하겠습니다. 영상 생성 API 한 번만 호출할 일이라면 프로젝트 화면까지 둘 이유가 없습니다.

준비물

• Windows, Linux, macOS용 Release 패키지 또는 로컬 소스 빌드 환경
• 텍스트 모델 API 주소, 영상 모델 API 주소, 이미지 모델 API 주소
• 프로젝트 자료와 생성 결과를 보관할 로컬 저장 공간

공식 Releases에는 Windows x64·ARM64, Linux x86_64·ARM64, macOS x64·ARM64 패키지가 있습니다. 첫 로그인 계정은 README에 적힌 admin / admin123이므로, 설치 직후 비밀번호부터 바꿔야 합니다.

1. 설치와 준비

데스크톱 앱은 Release 패키지를 받아 실행합니다. Docker 경로는 저장소를 내려받아 로컬에서 빌드하는 방식만 다룹니다. Docker 20.10 이상을 준비한 뒤 아래 명령을 실행합니다.

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn docker:local

수동 빌드도 가능합니다. docker build -t toonflow . 뒤 docker run -d -p <로컬_포트>:10588 -v <로컬_데이터_경로>:/app/data toonflow 형식으로 실행하면 됩니다. 웹 화면은 http://localhost:10588/web/index.html 경로를 사용합니다.

2. 제작 방식

설정 화면에서 텍스트, 이미지, 영상 모델 공급자를 등록합니다. README는 LLM 서비스 API 주소, Sora 또는 Doubao 영상 서비스 API 주소, Nano Banana Pro 이미지 모델 API 주소를 준비 항목으로 둡니다. 모델 이름과 API 주소는 같은 공급자 값으로 맞춰주시면 됩니다.

프로젝트를 만든 뒤 원문을 넣고 장면 이벤트를 추출합니다. ScriptAgent에서 이야기 구조와 대본을 만들고, ProductionAgent의 캔버스에서 캐릭터·소품·컷·영상 노드를 배치합니다. 재생성할 컷만 고른 뒤 결과를 다시 프로젝트에 붙이는 흐름입니다.

사용 방법

Release 앱은 실행 뒤 AI 구성 화면부터 확인합니다. Docker 빌드라면 브라우저 주소창에 http://localhost:10588/web/index.html을 넣어주시면 됩니다. 다음 순서는 프로젝트 생성, 원문 입력, 장면 이벤트 추출, 스토리보드 편집, 영상 노드 생성입니다.

적용 대상

• 맞는 경우: 여러 에피소드의 대본, 스토리보드, 영상 조각을 한 화면에서 이어 관리할 때
• 비교 기준: GPT·Claude·Codex CLI로 대본과 프롬프트를 만들고, Toonflow에서 장면 자산과 제작 순서를 묶을 때
• 맞지 않는 경우: 단일 이미지나 짧은 영상 하나만 만들 때, 모델 공급자 API를 따로 준비하기 어려울 때, 데스크톱 프로젝트 관리가 필요 없을 때

앞선 DramaClaw Docker Compose 영상 파이프라인 글처럼 영상 모델 선택과 제작 관리 화면은 분리해서 판단하는 편이 낫습니다.

확인

Docker 경로에서는 docker ps로 Toonflow 컨테이너가 실행 중인지 확인합니다. 브라우저에서 http://localhost:10588/web/index.html이 열리고 설정 화면에 텍스트·이미지·영상 모델 항목이 나타나면 정상적으로 설치된 것입니다.