VidEdu – AI-Powered Python Learning Platform

Overview

VidEdu is an AI-driven educational platform designed to automatically generate high-quality Python tutorial videos.
The system converts a user-selected Python topic into a structured educational script, animated visual explanations, and synchronized voice narration, delivering a complete learning experience through a web-based interface.

The platform integrates generative AI, programmatic animation, text-to-speech, and video processing into a single automated pipeline.

---

Key Capabilities

• AI-generated Python tutorial scripts using Gemini
• Automated Manim animation generation
• Voice narration using text-to-speech
• Video and audio synchronization
• Modular backend architecture
• Streamlit-based interactive frontend
• Designed for extensibility (quizzes, dashboards, learning paths)

---

Demo Video

A demonstration of the platform is available at the link below:

Demo Video (Google Drive):
https://drive.google.com/file/d/1kyk3AmCIUy7WD1mPUaF7-VpP0RLICYcl/view

---

Demo Images

---

Project Structure

videdu.ai/
│
├── backend/
│ └── content_generator/
│ ├── data/
│ ├── audio_gen.py
│ ├── auth.py
│ ├── chatbot.py
│ ├── check.py
│ ├── code_ch.py
│ ├── config.py
│ ├── dashboard.py
│ ├── database.py
│ ├── db_utils.py
│ ├── forum.py
│ ├── video_gen.py
│ ├── learning_path.py
│ ├── logo.jpeg
│ ├── main.py
│ ├── peer_collaboration.py
│ ├── requirements.txt
│ ├── audio.py
│ ├── quiz.py
│ ├── video_club/
│ └── utils/
│
├── static/
│ └── outputs/
│
├── utils/
│
├── .gitignore
├── README.md

---

Technology Stack

Layer	Technology
AI Script Generation	Gemini API
Animation Engine	Manim
Voice Narration	gTTS
Video Processing	MoviePy, FFmpeg
Frontend	Streamlit
Backend	Python
Data Handling	SQLite / File-based storage

---

Installation and Setup

Prerequisites

• Python 3.8 or higher
• FFmpeg installed and available in system PATH
• A valid Gemini API key

---

Clone the Repository

git clone https://github.com/<your-username>/videdu-ai.git
cd videdu-ai/backend/content_generator

Create and Activate Virtual Environment

python -m venv .venv

Windows (PowerShell):

.\.venv\Scripts\Activate.ps1

Environment Configuration

Create a .env file in the project root:

GEMINI_API_KEY=your_api_key_here

Install Dependencies

pip install -r requirements.txt

Running the Application

streamlit run main.py

The application will be available at:

http://localhost:8501

---

Application Workflow

• User selects a Python topic
• Gemini generates a structured educational script
• Manim produces animated explanations
• gTTS converts the script into voice narration
• MoviePy synchronizes video and audio
• Streamlit serves the final tutorial video to the user

---

System Pipeline / Architecture

Architecture Diagram

User Input (Topic)
↓
Gemini API
(Script Generation)
↓
Manim
(Animation Rendering)
↓
gTTS
(Voice Narration)
↓
MoviePy + FFmpeg
(Audio–Video Synchronization)
↓
Streamlit
(Web Interface & Output)

---

Design Principles

• AI output treated as untrusted input and validated before execution
• Modular pipeline for easy extension and debugging
• Clean separation between generation, rendering, and presentation
• Production-oriented error handling and logging
• Reproducible and automated content generation

---

Future Enhancements

• Adaptive quizzes with performance analytics
• User authentication and progress tracking
• Topic-wise learning paths
• Multi-language tutorial generation
• Instructor voice customization
• Cloud deployment support

---

License

• This project is licensed under the MIT License
• You are free to use, modify, and distribute this software with attribution

---

Author

• Guru Divya Darshini U
• AI-Driven Educational Systems
• Python | Generative AI | Educational Technology

---