# Shorts Studio

Turns a voice memo into a finished short video. An AI writes a real story arc, generates pictures with a consistent main character, narrates it in my own cloned voice, then renders it with transitions, captions and music. It has a hard monthly spend limit.

**Status:** Live · Projects · 2026

- **Local checkout:** `/Users/simon/Developer/shorts-studio` (branch `main`, last commit a791c6f, 2026-10-16 — README: public subdomain)
- **Repository:** https://github.com/ShimonNavon/shorts-studio
- **On another machine:** `git clone https://github.com/ShimonNavon/shorts-studio` — the paths below are Simon's Mac
- **Live:** https://shorts.navonsimon.com/
- **Where it runs:** namespace shorts-studio · NodePort 30091 · PVC on ubuntu04
- **Note:** Sign-in required

## Stack

Python 3.12, FastAPI-style app, FLUX, Chatterbox TTS on fal, ffmpeg, Kubernetes, local-path PVC

## Start here

- `app/` — web app, pipeline stages, renderer
- `deploy/app.yaml` — Deployment, Service, PVC, MONTHLY_BUDGET (default 5 USD)
- `deploy/deploy.sh` — regenerates ConfigMaps and Secret, applies, restarts
- `tools/import_be_free.py` — one-off import of the earlier Be Free work

## Commands

- **Deploy:** `./deploy/deploy.sh`
- **Local app:** `see README; the deployed app is the supported path`

## Deploy and where it runs

- Namespace shorts-studio, NodePort 30091 on ubuntu03.
- Public https://shorts.navonsimon.com/ via ubuntu01 edge nginx + Cloudflare tunnel.
- PVC shorts-studio/data on ubuntu04 holds library, projects, renders and the spend ledger.
- Stock python:3.12-slim image; an init container installs numpy, Pillow, ffmpeg and the font into the PVC once.

## Current state

Live behind an access key. Monthly spend cap enforced; the Spend page shows recorded calls.

## Watch out

- Every paid call is written to /data/ledger.jsonl before it is sent and is never auto-retried; do not add retries around paid calls.
- Prices in the UI are estimates; keep them labelled that way.
- The access key is exchanged for a cookie; do not expose the app publicly without the key.
- Generation costs real money: confirm before running pipeline stages against live providers.

## Secrets — locations only, never print values

- .private/access-key.txt and .private/open-studio.html (git-ignored).
- Hugging Face token read from ~/.ssh/hf_token at deploy time into a Kubernetes Secret.

## Links

- [Open studio](https://shorts.navonsimon.com/)

## Tags

FLUX, Voice cloning, Llama 3.3, ffmpeg, Kubernetes

---

Brief generated 2026-11-08 from `~/Developer/my-projects/context/`. Canonical URL: https://projects.navonsimon.com/context/shorts-studio.md
