AI 기술을 기반으로 한 숏폼 드라마/만화 영상 제작 도구로, 소설 텍스트로부터 스토리보드(Storyboard), 캐릭터, 장면을 자동으로 생성하고 완전한 영상으로 제작하는 기능을 지원합니다.

Important

테스트 버전 선언: 본 프로젝트는 현재 초기 테스트 단계에 있으며, 현재 개발자가 1명뿐이라 일부 버그와 미비한 점이 존재합니다. 빠르게 반복 업데이트(Iteration)를 진행 중이므로, 그룹에 참여하여 문제점과 요구사항을 피드백해 주시고 프로젝트 업데이트를 지속적으로 확인해 주세요! 현재 업데이트가 매우 빈번하게 이루어지고 있으며, 향후 대량의 신기능 추가 및 효과 최적화가 예정되어 있습니다. 우리의 목표는 업계 최강의 AI 도구가 되는 것입니다!

• 🎬
  AI 시나리오 분석— 소설을 자동으로 분석하여 캐릭터, 장면, 줄거리를 추출 - 🎨
  캐릭터 & 장면 생성— AI를 통해 일관성 있는 인물 및 장면 이미지 생성 - 📽️
  스토리보드 영상 제작— 스토리보드를 자동으로 생성하고 영상을 합성 - 🎙️
  AI 더빙— 다중 캐릭터 음성 합성 - 🌐
  다국어 지원— 중국어 / 영어 인터페이스, 우측 상단에서 원클릭 전환

전제 조건: Docker Desktop 설치

저장소를 클론(Clone)할 필요 없이 다운로드 후 바로 사용 가능합니다:

# docker-compose.yml 다운로드
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml
# 모든 서비스 시작
...

⚠️ 현재 테스트 버전이므로 버전 간 데이터베이스(Database) 호환이 되지 않습니다. 업그레이드 시 먼저 기존 데이터를 삭제하십시오:

docker compose down -v
docker rmi ghcr.io/saturndec/waoowaoo:latest
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml
...

실행 후에는

이전 버전의 캐시로 인한 이상 현상을 방지하기 위해 브라우저 캐시를 비우고 다시 로그인해 주세요.

git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
docker compose up -d

버전 업데이트:

git pull
docker compose down && docker compose up -d --build

git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
# 환경 변수 설정 파일 복사 (npm install 전에 반드시 완료해야 함)
...

Warning

npx prisma db push 단계를 건너뛰면

모든 데이터베이스 테이블이 존재하지 않게 되어, 실행 후 The table 'tasks' does not exist 에러가 발생합니다.

반드시 이 명령을 먼저 실행한 후 개발 서버를 시작하십시오.

http://localhost:13000 (방법 1, 2) 또는 http://localhost:3000 (방법 3)에 접속하여 사용을 시작하세요!

처음 실행 시 데이터베이스 초기화가 자동으로 완료되므로 별도의 추가 설정이 필요하지 않습니다.

실행 후 **설정 센터(Settings Center)**에 진입하여 AI 서비스의 API Key를 설정하세요. 내장된 설정 튜토리얼이 제공됩니다.

💡

주의: 현재는 각 서비스 제공업체의 공식 API 사용을 권장합니다. 제3자 호환 형식 (OpenAI Compatible)은 아직 완벽하지 않으며, 향후 버전에서 지속적으로 최적화될 예정입니다.

프레임워크: Next.js 15 + React 19
데이터베이스: MySQL + Prisma ORM
큐(Queue): Redis + BullMQ
스타일: Tailwind CSS v4
인증: NextAuth.js

본 프로젝트는 핵심 팀에 의해 독립적으로 유지 관리됩니다. 다음과 같은 방법으로 참여하실 수 있습니다:

• 🐛 Issue를 제출하여 버그 피드백
• 💡 Issue를 제출하여 기능 제안
• 🔧 참고용 Pull Request 제출 — 모든 PR의 논리를 신중하게 검토하지만, 최종 수정 및 구현은 팀에서 직접 수행하며 외부 PR을 직접 병합(Merge)하지는 않습니다.

Made with ❤️ by waoowaoo team