GitHub – Achint08/90210: 90210 – like the show · but you’re the showrunner · GitHub

Like the show. But you’re the showrunner.

All the drama. None of the property tax.

A production-grade local app that turns a screenplay into a finished short film with synchronized video, native audio, dialogue, music, and subtitles. Powered by Google Veo 3.1, Nano Banana, Gemini 2.5 Pro, and ElevenLabs Music.

Every quality decision is mathematically grounded: a composite Quality Oracle (VideoScore, ViCLIP, LAION aesthetic, MUSIQ, ArcFace, LPIPS, Whisper) drives auto re-roll and adaptive tier escalation. A Story Oracle (Reagan-6 arcs, TRIPOD turning points, Average Shot Length, SBERT coherence) keeps the narrative on target.

# 0. one-time
python3 -m venv .venv
.venv/bin/pip install -e ./backend          # installs FastAPI + Pydantic + Google + ElevenLabs deps
cp .env.example .env                         # fill in GEMINI_API_KEY and ELEVENLABS_API_KEY

# 1. Backend
./run-backend.sh                             # starts uvicorn at http://localhost:8000
# (the script sets PYTHONPATH because Homebrew Python 3.14 ships its own
#  sitecustomize.py that breaks venv editable installs — PYTHONPATH sidesteps it.)

# 2. Frontend (new shell)
cd frontend
pnpm install                                 # or npm install
pnpm dev                                     # → http://localhost:3000

# 3. iPhone access
#    - same WiFi: http://:3000 → Safari Share → Add to Home Screen
#    - off-WiFi: tailscale serve / funnel (see docs)

# 4. Optional Quality Oracle (heavy ML deps; ~3GB)
.venv/bin/pip install -e "./backend[oracles]"

• Design spec: docs/superpowers/specs/2026-05-09-screenplay-to-movie-design.md
• Veo 3.1 reference: docs/superpowers/research/veo-3.1-deep-dive.md
• Cost / latency / quality math: docs/superpowers/research/cost_latency_quality_math.py

A 2-min movie typically costs ~$20.

See spec §4. Local FastAPI backend + Next.js PWA frontend. PWA installs to home screen on iOS Safari for native-app-like experience.