https://github.com/jerryblessed/slideshowai
https://github.com/jerryblessed/slideshowai
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jerryblessed/slideshowai
- Owner: Jerryblessed
- Created: 2025-07-12T16:11:59.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-12T18:11:41.000Z (12 months ago)
- Last Synced: 2025-07-12T19:29:10.195Z (12 months ago)
- Language: Python
- Size: 8.86 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# 📆 AI Slideshow Creator – Installation Guide
*Also known as Prompt2Slides*
This guide helps you set up the **AI Slideshow Creator**, a Flask web app that uses **Gemini, Pexels, Pixabay, and ElevenLabs APIs** to generate **AI-powered, offline-ready educational slideshows** — complete with narration, images, and videos — all from a single prompt.
> 🎥 [**Pitch Deck**](https://docs.google.com/presentation/d/1la6VuclIqyZKOKgzifkMSvo_3OJAu-2QX1-pff0Y2a0/edit?usp=sharing) – View the official presentation slide submitted for United Hacks V5!
>
> 🌐 [**Live Web App**](https://lighteducation.pythonanywhere.com/) – Try out the deployed version now!
---
## ✅ Requirements
* Python 3.9+
* `pip` (Python package installer)
* API Keys for:
* [Google Gemini API](https://makersuite.google.com/)
* [Pixabay API](https://pixabay.com/api/docs/)
* [Pexels API](https://www.pexels.com/api/)
* [ElevenLabs API](https://www.elevenlabs.io/)
---
## 🚀 Setup Instructions
### 1. Clone the Repository
```bash
git clone https://github.com/Jerryblessed/slideshowai.git
cd ai-slideshow-creator
```
### 2. (Optional) Create and Activate Virtual Environment
```bash
python -m venv venv
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate
```
### 3. Install Dependencies
```bash
pip install -r requirements.txt
```
### 4. Add Your API Keys
You can either:
* Create a `.env` file in the root directory, or
* Set the variables in your terminal environment:
```bash
export GEMINI_API_KEY="your_gemini_api_key"
export PIXABAY_API_KEY="your_pixabay_api_key"
export PEXELS_API_KEY="your_pexels_api_key"
export ELEVENLABS_API_KEY="your_elevenlabs_api_key"
```
For Windows CMD:
```cmd
set GEMINI_API_KEY=your_gemini_api_key
set PIXABAY_API_KEY=your_pixabay_api_key
set PEXELS_API_KEY=your_pexels_api_key
set ELEVENLABS_API_KEY=your_elevenlabs_api_key
```
### 5. Run the Flask App
```bash
python app.py
```
Then open your browser and visit:
```text
http://127.0.0.1:5000
```
---
## 📁 Output
* Each prompt generates a **.zip file** containing:
* HTML slideshow
* Slide-by-slide AI voice narration
* Embedded images and video links
---
## 💡 Deployment Tip
If deploying on a cloud platform (e.g. Render, Heroku), configure the API keys via environment variable settings in the dashboard.
To keep local development secure and clean, use `.env` + [python-dotenv](https://pypi.org/project/python-dotenv/).
---
📚 For full context and slides, view the
🎞️ **[Official Pitch Deck here »](https://docs.google.com/presentation/d/1la6VuclIqyZKOKgzifkMSvo_3OJAu-2QX1-pff0Y2a0/edit?usp=sharing)**
🌐 **Try it live**: [https://lighteducation.pythonanywhere.com/](https://lighteducation.pythonanywhere.com/)
Happy hacking, presenting, and teaching — anywhere, even offline! 🧠💡✨