make-your-video

Auto-generate short-form videos (TikTok/Reels/Shorts) from a topic.

Architecture

• backend/ — FastAPI (Python). Pipeline: LLM script → TTS → stock video → ffmpeg → MP4.
• frontend/ — Next.js 15 + Tailwind + shadcn/ui.
• desktop/ — Tauri 2 (Rust) shell.

See docs/ for full design. The design document for the make-your-video project — an automated tool for creating short-form videos (TikTok/Reels/YouTube Shorts) from a topic, inspired by MoneyPrinterTurbo but with a new 3-tier architecture.

---

Prerequisites

Tool	Min version	Install
Node.js	20	https://nodejs.org
pnpm	10	npm i -g pnpm
Python	3.11	https://python.org
uv	0.4+	curl -LsSf https://astral.sh/uv/install.sh | sh
Rust / Cargo	stable	https://rustup.rs (only for Tauri desktop)

---

First-time setup

# 1. Install JS deps (root + frontend workspace)
pnpm install

# 2. Install Python deps
cd backend && uv sync && cd ..

# 3. Copy env files
cp backend/.env.example backend/.env
cp frontend/.env.local.example frontend/.env.local

Optional: Edit backend/.env to add API keys (Pexels, Azure TTS, OpenAI…). The app starts without them; video creation will fail gracefully at the relevant step.

---

Development

pnpm dev              # starts backend (port 8080) + frontend (port 3000) concurrently
pnpm dev:desktop      # starts backend + frontend + Tauri shell together

Service	URL
Frontend (web mode)	http://localhost:3000
Backend API	http://127.0.0.1:8080
Backend Swagger docs	http://127.0.0.1:8080/docs

What you should see (P4)

1. http://localhost:3000 → auto-redirects to /create
2. 4-step wizard: Subject → Voice → Visual → Review
3. Click Create video → POST /api/v1/videos fires → toast + redirect to /tasks/<id>
4. /tasks/<id> shows a stub page (live progress comes in P5)

---

Testing

# Frontend unit tests (vitest + RTL)
cd frontend && pnpm test

# Backend unit tests (pytest)
pnpm test:backend

# Type-check frontend
cd frontend && pnpm typecheck

---

Build

pnpm build:frontend   # Next.js production build
pnpm build:desktop    # Tauri .app / .exe