Skip to content

Achint08/90210

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📍🎬 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

Service Used for Cost (May 2026)
Gemini API Veo 3.1 (video+audio), Nano Banana (portraits), Gemini 2.5 Pro (Director) $0.10–0.40/sec video
ElevenLabs Music tracks $0.01/sec music

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.

About

90210 - like the show · but you're the showrunner

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors