Run a focused deck studio on your own machine.

Install and run

git clone https://github.com/OthmaneBlial/Storyboard-Studio.git
cd Storyboard-Studio
make setup
make runCopy

Open http://127.0.0.1:8000. Python 3.10 or newer is required.

Optional Gemini outlining

The app works without an API key. To ask Gemini for a richer first draft, export your own key before starting the server:

export GEMINI_API_KEY="your-key"
make runCopy

Gemini failures return an editable local outline. Your key is read only from the process environment and must never be committed.

Command-line export

python3 generate_pptx.py \
  --input examples/product-brief.json \
  --output output/my-deck.pptxCopy

The included JSON example is runnable and produces a title slide plus three editable content slides.

Local API

Interactive OpenAPI documentation is available at /docs while the local server runs.

• GET /api/health — readiness and whether Gemini is configured.
• POST /api/content — a validated outline from a brief.
• POST /api/presentations — a PPTX from an outline.

Privacy and retention

Storyboard Studio does not create accounts, profiles, analytics events, or a presentation database. A generated export is kept only in the local output/ folder for download, then removed after 24 hours. Turning on Gemini sends the brief to that provider; use it only for material you are allowed to share.