An AI-powered tool for creating short drama / comic videos — automatically generates storyboards, characters, and scenes from novel text, then assembles them into complete videos.
中文文档 · Join Waitlist · Report Bug
IMPORTANT
Beta Notice: This project is currently in its early beta stage. As it is currently a solo-developed project, some bugs and imperfections are to be expected. We are iterating rapidly — please stay tuned for frequent updates! We are committed to rolling out a massive roadmap of new features and optimizations, with the ultimate goal of becoming the top-tier solution in the industry. Your feedback and feature requests are highly welcome!
- 🎬 AI Script Analysis — Parse novels, extract characters, scenes & plot automatically
- 🎨 Character & Scene Generation — Consistent AI-generated character and scene images
- 📽️ Storyboard Video — Auto-generate shots and compose into complete videos
- 🎙️ AI Voiceover — Multi-character voice synthesis
- 🌐 Bilingual UI — Chinese / English, switch in the top-right corner
Prerequisites: Install Docker Desktop
No need to clone the repository. Just download and run:
# Download docker-compose.yml
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml
# Start all services
docker compose up -d
⚠️ This is a beta version. Database is not compatible between versions. To upgrade, clear old data first:
docker compose down -v
docker rmi ghcr.io/saturndec/waoowaoo:latest
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml
docker compose up -d
After starting, please clear your browser cache and log in again to avoid issues caused by stale cache.
git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
docker compose up -d
To update:
git pull
docker compose down && docker compose up -d --build
git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
# Copy environment config (must be done before npm install)
cp .env.example .env
# ⚠️ Edit .env to fill in your AI API Keys (NEXTAUTH_URL defaults to http://localhost:3000, no change needed)
npm install
# Start infrastructure only
docker compose up mysql redis minio -d
# Run database migration
npx prisma db push
# Start development server
npm run dev
Visit http://localhost:13000 (Method 1 & 2) or http://localhost:3000 (Method 3) to get started!
The database is initialized automatically on first launch — no extra configuration needed.
TIP
If you experience lag: HTTP mode may limit browser connections. Install Caddy for HTTPS:
caddy run --config Caddyfile
Then visit https://localhost:1443
After launching, go to Settings to configure your AI service API keys. A built-in guide is provided.
💡 Note: Currently only official provider APIs are recommended. Third-party compatible formats (OpenAI Compatible) are not yet fully supported and will be improved in future releases.
- Framework: Next.js 15 + React 19
- Database: MySQL + Prisma ORM
- Queue: Redis + BullMQ
- Styling: Tailwind CSS v4
- Auth: NextAuth.js
This project is maintained by the core team. You're welcome to contribute by:
- 🐛 Filing Issues — report bugs
- 💡 Filing Issues — propose features
- 🔧 Submitting Pull Requests as references — we review every PR carefully for ideas, but the team implements fixes internally rather than merging external PRs directly
Made with ❤️ by waoowaoo team
