AI PowerPoint Generator

A Streamlit web app that leverages Google’s Gemini generative AI to create professional PowerPoint presentations automatically from a topic input. The app can generate slide outlines and content, optionally enhancing slides with related images fetched from the Pexels API.

---

Features

• Generate presentation slide outlines with AI based on any topic.
• Customize number of slides.
• Optionally include relevant stock images using Pexels.
• Use multiple Gemini models (Pro, Flash, etc.) for different speed and quality preferences.
• Download fully formatted PowerPoint (.pptx) files.
• Debug mode to show raw AI generation output for troubleshooting.

---

Getting Started

Prerequisites

• Python 3.8 or higher
• Google Gemini API key with access to generative AI models.
• (Optional) Pexels API key to fetch stock images.

Installation

1. Clone the repository:

git clone <repository-url>
cd powerpoint-generator

2. Install required dependencies:

pip install -r requirements.txt

3. Set up environment variables:

# Create a .env file in the project root
GEMINI_API_KEY=your_gemini_api_key_here
PEXELS_API_KEY=your_pexels_api_key_here

Required Dependencies

google-generativeai
python-pptx
requests
python-dotenv

Getting API Keys

Gemini API Key

1. Visit Google AI Studio
2. Sign in with your Google account
3. Create a new API key
4. Copy the key to your .env file

Pexels API Key

1. Visit Pexels API
2. Sign up for a free account
3. Generate an API key
4. Copy the key to your .env file

Usage

Basic Usage

from powerpoint_generator import PowerPointGenerator

# Initialize the generator
generator = PowerPointGenerator()

# Generate a presentation
presentation = generator.create_presentation(
    topic="Climate Change",
    num_slides=5
)

# Save the presentation
presentation.save("climate_change_presentation.pptx")

Command Line Usage

python generate_presentation.py --topic "Your Topic" --slides 5 --output "presentation.pptx"

Project Structure

powerpoint-generator/
├── README.md
├── requirements.txt
├── .env.example
├── generate_presentation.py
├── powerpoint_generator/
│   ├── __init__.py
│   ├── generator.py
│   ├── gemini_client.py
│   └── pexels_client.py
└── examples/
    └── sample_presentation.pptx

Configuration

The application uses the following default settings:

• Gemini Model: gemini-2.0-flash-exp (or gemini-1.5-pro as fallback)
• Image Resolution: 1920x1080 (landscape)
• Max Images per Slide: 1
• Content Language: English

API Limits

Gemini API

• Free tier: 15 requests per minute
• Rate limiting is handled automatically

Pexels API

• Free tier: 200 requests per hour
• 20,000 requests per month

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Commit your changes (git commit -am 'Add new feature')
4. Push to the branch (git push origin feature/new-feature)
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Troubleshooting

Common Issues

API Key Errors

• Ensure your API keys are correctly set in the .env file
• Verify that your API keys are active and have sufficient quota

Image Download Failures

• Check your internet connection
• Verify Pexels API key is valid
• Some images may not be available in the requested resolution

PowerPoint Generation Errors

• Ensure you have write permissions in the output directory
• Check that all required dependencies are installed

Acknowledgments

• Google Gemini for AI content generation
• Pexels for providing free stock photography
• python-pptx for PowerPoint file manipulation

Support

For issues and questions, please open an issue on the GitHub repository or contact the maintainers.