Skip to content
elena-kalininaPublic

About

Recast transforms complex documents and datasets into short, entertaining plays — comic strips with punchline videos and in-character voice Q&A. Upload a 40-page legal document, a health wearable CSV, or a financial spreadsheet, pick a genre, and watch it come alive as a Detective Noir investigation, a Dr. House diagnosis, or a Sports Commentary.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🎭 Recast

Any file. Any genre. One short play.

Recast transforms complex documents and datasets into short, entertaining plays — comic strips with punchline videos and in-character voice Q&A. Upload a 40-page legal document, a health wearable CSV, or a financial spreadsheet, pick a genre, and watch it come alive as a Detective Noir investigation, a Dr. House diagnosis, or a Sports Commentary battle.

Because understanding your data shouldn't feel like homework.

Recast comic strip — French Cooking Show

How It Works

  1. Upload any PDF, CSV, or Excel file
  2. Pick a genre — Telenovela, Dr. House, Nature Documentary, Courtroom Thriller, Sports Commentary, Shakespearean Drama, Quiz Show, Detective Noir, Anime, Cooking Show, or Reality TV
  3. Pick a language — 15 languages supported
  4. Generate — Recast analyzes your content, writes a comedy script, and renders a 4-panel comic strip with speech bubbles. A punchline video generates in the background.
  5. Ask follow-up questions — "What's the fine print?", "Should I panic?", "Roast this document" — all answered in character, with voice

Why Recast?

  • Accessibility — Legal docs, medical data, and financial reports are impenetrable for most people. Recast makes them understandable and memorable.
  • Multilingual — The same document can become a Spanish telenovela, a German sports commentary, or a French cooking show. Real accessibility, not a gimmick.
  • Interactive — Not just a static summary. Ask questions, get answers in character, hear them spoken aloud. The comedy makes the facts stick.

Tech Stack

Partner Role
Google Gemini Content analysis, script generation, in-character Q&A (with model fallback chain)
Fal.ai Comic panel images (FLUX Schnell) + punchline videos (Seedance 2.0)
Gradium Genre-aware text-to-speech with voice matching
Gradio Interactive UI

Setup

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your API keys
python app.py

Environment Variables

GEMINI_API_KEY=your-gemini-key
FAL_KEY=your-fal-ai-key
GRADIUM_API_KEY=your-gradium-key

Project Structure

Recast/
├── app.py                  # Main Gradio application
├── core/
│   ├── file_processor.py   # PDF/CSV/Excel text extraction
│   ├── gemini_client.py    # Gemini API with automatic model fallback
│   ├── fal_client.py       # Fal.ai video + image generation
│   ├── gemini_voice.py     # Gemini Live API for voice Q&A
│   ├── gradium_tts.py      # Genre-aware TTS with voice matching
│   └── comic_generator.py  # Panel parsing, image gen, speech bubbles, grid layout
├── prompts/
│   ├── script_generation.py  # Genre definitions + script prompts
│   └── character_qa.py       # In-character Q&A prompts + smart follow-ups
├── demo_data/              # Sample CSV datasets for demos
├── assets/                 # Screenshots and examples
└── requirements.txt

Built at {Tech: Europe} AI Hackathon — London Edition 🇬🇧

About

Recast transforms complex documents and datasets into short, entertaining plays — comic strips with punchline videos and in-character voice Q&A. Upload a 40-page legal document, a health wearable CSV, or a financial spreadsheet, pick a genre, and watch it come alive as a Detective Noir investigation, a Dr. House diagnosis, or a Sports Commentary.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages