TL;DR

Huobao Drama는 한 문장이나 소설을 입력해 대본, 캐릭터, 장면, Storyboard, 생성 영상, 자막과 최종 합성본까지 처리하는 독립 실행형 AI 단편 제작 플랫폼입니다. Nuxt 3·Vue 3 프런트엔드와 Hono·Drizzle ORM·MySQL 백엔드가 Mastra Agent 4개 및 FFmpeg·Sharp 처리 파이프라인으로 연결됩니다. Docker Compose나 다중 아키텍처 Docker 이미지로 배포할 수 있고, AI 설정은 웹 화면에서 저장하며 Ollama 같은 OpenAI 호환 엔드포인트도 연결할 수 있습니다. 다만 영상·이미지 생성을 위해 외부 모델 API가 필요하고 CC BY-NC-SA 4.0 라이선스가 적용되므로 상업적 서비스에 바로 포함할 때는 비용과 라이선스를 함께 점검해야 합니다.

핵심 포인트

• 독립 실행형 AI 콘텐츠 제작 도구로, 특정 클라우드 플랫폼의 플러그인이나 MCP server가 아니라 자체 웹 애플리케이션입니다. Nuxt 3와 Vue 3 프런트엔드, Hono와 Drizzle ORM 기반 Node.js 백엔드, MySQL 데이터베이스가 하나의 제작 흐름을 구성합니다. 개발자는 웹 화면에서 대본 생성부터 캐릭터·장면 추출, Storyboard 작성, 이미지·영상 생성, FFmpeg 합성까지 이어지는 전체 단편 제작 과정을 운영할 수 있습니다.
• Mastra Agent 4개가 소설을 형식화된 대본으로 바꾸고, 캐릭터·장면·소품을 추출한 뒤, 대본을 Storyboard와 이미지·영상 Prompt로 변환합니다. 각 Agent의 Skill 파일은 `backend/workspace/skills/`에 저장되며 설정 화면에서 온라인 편집이 가능하고, 데이터베이스 설정과 Skill 확장을 함께 사용합니다. 따라서 단순한 영상 API 호출 예제보다 반복 제작 업무를 자동화하려는 팀에 적합하지만, 결과 품질은 연결한 AI 모델과 Prompt 구성에 좌우됩니다.
• 텍스트 모델은 OpenAI 호환 인터페이스와 Gemini를 사용하고, 이미지 생성은 OpenAI·Gemini·火山引擎, 영상 생성은 火山引擎 Seedance 2.0 계열을 사용합니다. AI 서비스의 API Key와 Base URL, 모델 설정은 환경 변수 파일이 아니라 웹 설정 화면을 통해 데이터베이스에 저장하며, Huobao API Key를 붙여 넣어 텍스트·이미지·영상 설정을 한 번에 구성할 수도 있습니다. 외부 AI 서비스 비용과 Huobao API 의존성을 피하려면 지원되는 자체 OpenAI 호환 엔드포인트나 Ollama를 별도로 연결해야 합니다.
• Docker Compose는 MySQL 8.4와 애플리케이션을 함께 실행하고, Docker Hub에는 `linux/amd64`와 `linux/arm64`용 사전 빌드 이미지가 제공됩니다. FFmpeg와 FFprobe는 `ffmpeg-static` 및 `ffprobe-static` npm 패키지에 포함되어 별도 시스템 설치가 필요 없으며, `data`와 `workspace`를 Volume으로 연결해 생성물과 Agent Skill을 유지합니다. 라이선스는 CC BY-NC-SA 4.0이므로 상업적 사용이나 배포 방식은 적용 조건을 먼저 확인해야 하며, README에는 스타 14,025개와 포크 2,614개가 기록되어 있습니다.