🎬 AI Storyteller & YouTube Video Machine 🚀

An end-to-end AI creation studio powered by Groq (Llama 3.3 70B), Edge-TTS (Natural Neural Voices), Pollinations.ai (FLUX 3D Pixar Art), and MoviePy 2.x (Ken Burns Animation & Video Assembly).

Built to generate upload-ready YouTube Kids Stories, Nursery Rhymes, and Shorts (.MP4) completely free without expensive subscriptions.

---

🌟 What's New: YouTube Video Studio vs Original

Feature	Original Version	Upgraded Version 🎬
Output	Text + Still Image + Player	Direct .MP4 Video Export (YouTube Landscape & Shorts)
Voice Engine	Robotic gTTS	Edge-TTS Natural Neural Voices (hi-IN-SwaraNeural, hi-IN-MadhurNeural)
Animation	Static picture	Ken Burns Pan & Zoom Motion Effect (Smooth 24fps)
Subtitles	Plain text on UI	Bouncing / Centered Hindi Subtitle Pill Overlay
Art Style	Generic random styles	3D Disney/Pixar Kids Animation, Anime, Storybook presets
Cost	Free	100% Free / Zero API Subscriptions

---

🛠️ Architecture

graph TD
    A[User Topic: e.g. Gubbare Wala Nursery Rhyme] --> B[Groq Llama 3.3 Engine]
    B -->|Scene-by-Scene JSON| C[Scene Director]
    C -->|Scene Dialogues| D[Edge-TTS Engine: hi-IN-SwaraNeural]
    C -->|Visual Prompts| E[Pollinations FLUX: 3D Pixar Style]
    D -->|High Fidelity Speech MP3| F[Video Assembly Engine]
    E -->|High Resolution PNG| F
    F -->|Ken Burns Zoom + Audio Sync + Subtitles| G[Final YouTube MP4 Video]

Loading

---

📁 Project Structure

AI-Storyteller-Machine/
├── app.py             # Streamlit Studio (Video Generator + Interactive Storyteller)
├── story_engine.py    # Groq Llama 3.3 scene script generator (JSON schema)
├── image_gen.py       # Pollinations.ai 3D Pixar & animation styler
├── tts.py             # Edge-TTS high-fidelity natural Hindi/English voice engine
├── video_engine.py    # MoviePy 2.x Ken Burns motion, subtitle overlays & MP4 encoder
├── requirements.txt   # Package dependencies
├── .env.example       # Free Groq API key configuration
└── README.md          # Documentation

---

🚀 Quick Setup & Run

1. Install Dependencies

git clone https://github.com/VimalN2005/AI-Storyteller-Machine.git
cd AI-Storyteller-Machine
pip install -r requirements.txt

2. Configure Groq API Key

Get your free API key at console.groq.com and add it to .env:

GROQ_API_KEY=gsk_your_groq_api_key_here

(Or simply enter it directly into the Streamlit sidebar password field!)

3. Launch App

streamlit run app.py

---

💡 YouTube Kids Creation Workflow (Zero Cost)

1. Script & Scenes: Type your topic (e.g. "गुब्बारे वाला और नन्हे बच्चे").
2. Format Selection: Choose 16:9 (Standard YouTube) or 9:16 (Shorts/Reels).
3. Voice Selection: Select hi-IN-SwaraNeural (Lively female tone for rhymes).
4. Generate & Download: Click Generate YouTube Video to download .mp4.
5. (Optional Polish): Import into CapCut Desktop (Free) to add background nursery music and auto-sound effects!