README.md

🎬 YouTube Shorts Generator — AI-Powered Highlights to Viral Clips

Track: agent-demo-track
✨ Turn long-form videos into scroll-stopping YouTube Shorts using AI — fast, accurate, and automated.

---

🧠 Overview

YouTube Shorts Generator transforms long videos into engaging, high-quality Shorts using AI. It automates the entire process — from transcription and highlight detection to clipping and captioning — saving creators hours of editing time and thousands in production cost.

Whether you're an educator, podcaster, or content creator, this tool helps you repurpose long content into viral-ready clips for platforms like YouTube Shorts, Instagram Reels, and TikTok.

---

🎥 Demo Video

👉 🔗 Watch the Demo

---

🚀 Features

• ✅ Smart Highlight Detection: Automatically selects attention-grabbing moments based on content type.
• ✅ Flexible Clip Duration: Generate 15–90 second videos tailored to platform requirements.
• ✅ Multiple Content Modes: Choose from Educational, Funny, Dramatic, Surprising, Inspiring, etc.
• ✅ Accurate Transcription: Powered by OpenAI Whisper for top-tier audio-to-text performance.
• ✅ AI-Generated Captions & Titles: Enhance engagement with catchy, context-aware overlays.
• ✅ Seamless YouTube Integration: Process videos from a simple YouTube URL.
• ✅ Download or Auto-Schedule: Direct download or schedule uploads to your Shorts channel.

---

🧰 Tech Stack

• Python 3.9+
• Gradio (for web UI)
• FFmpeg (video slicing)
• OpenAI Whisper (transcription)
• OpenAI GPT / Gemini LLM (caption generation, timestamp detection)
• Modal (cloud deployment & serverless compute)

---

🏗️ Architecture

📦 Pipeline:

1. Input: YouTube link or local file
2. Transcription: Whisper model extracts accurate timestamped transcript
3. Analysis: Gemini/GPT filters highlights based on selected content style
4. Clipping: FFmpeg trims segments using timestamps
5. Captioning: Catchy captions & hashtags generated
6. Output: Final clips ready to download or publish

---

🧪 How to Use

⚙️ Prerequisites

• Python 3.9+
• FFmpeg installed & added to PATH
• OpenAI API Key

---

💻 Installation

git clone https://github.com/VanshGoyal000/shorts-generator
cd shorts-generator
pip install -r requirements.txt
3. Create a `.env` file with your API keys:

OPENAI_API_KEY=your_key_here

### Running the Application

There are two ways to run the application:

1. **Local Processing (Recommended for beginners)**:
```bash
python run.py

This launches a Gradio web interface that processes videos locally.

2. Modal Processing (More powerful, requires Modal account):

   python modal_deploy.py  # First deploy the Modal app
   python run_modal.py     # Then run the Gradio interface using Modal
   

📊 Stats / Results

• Average processing time: ~3-5 minutes per video
• Supports videos up to 3 hours long
• 6 different content types for targeted short creation
• Clip duration range: 15-90 seconds (customizable)

👤 Team

• Vansh Goyal (Lead Developer)
• github.com/VanshGoyal000
• linkedin.com/in/vanshcodeworks

Usage Tips

1. For the best results, select the appropriate content type that matches your video (funny, educational, etc.)
2. Variable-length clips are more engaging than fixed-length clips
3. Adjust the min/max duration based on your platform requirements
4. Try different numbers of highlights to get the best moments from your video

Troubleshooting

• If you see "ConnectionResetError" messages on Windows, these are harmless and can be ignored
• If video processing fails, try clearing the cache in %TEMP%/shorts_generator_cache
• Check that FFmpeg is properly installed and accessible from your PATH

🏆 Submission Tags

• agent-demo-track
• 🤖 Gradio Agents & MCP Hackathon 2025 🚀