Achint08/90210

Source: https://github.com/Achint08/90210

📍🎬 90210

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.

Quick start

# 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://<laptop-ip>: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]"

Documentation

• 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

Required API keys

A 2-min movie typically costs ~$20.

Architecture

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