README_HF.md

---
title: PowerPoint Script Generator
emoji: 🎤
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
---

# 🎤 PowerPoint Script Generator

**Generate professional presentation scripts instantly using AI!**

This Gradio application uses **Falcon3-1B-Instruct** to automatically create speaker scripts for PowerPoint presentations on any topic.

## ✨ Features

- 📝 **Topic-based generation** - Enter any presentation topic
- 📊 **Customizable slides** - Generate scripts for 3-10 slides
- 👥 **Multiple audiences** - Students, executives, technical professionals, and more
- 🎨 **Tone options** - Professional, casual, technical, inspirational, etc.
- ⚙️ **Advanced controls** - Adjust temperature and max tokens
- 💡 **Example topics** - Pre-loaded examples to get started
- ⚡ **Cloud-based** - No installation required!

## 🚀 How to Use

1. **Enter your presentation topic** (e.g., "Introduction to Cloud Computing")
2. **Select number of slides** (3-10 recommended)
3. **Choose your audience** (who will be listening?)
4. **Select tone** (how formal should it be?)
5. **Click Generate** and wait 10-30 seconds
6. **Copy your script** and use it in your presentation!

## 📋 What You Get

For each slide, you'll receive:
- **Slide Title** - Clear, descriptive heading
- **Speaker Script** - 2-4 sentences of what to say
- **Key Points** - Bullet points highlighting main ideas
- **Timing** - Suggested duration for the slide

## 💡 Example Topics

- "Quarterly Sales Performance Review"
- "Introduction to Machine Learning"
- "Cybersecurity Best Practices"
- "The Future of Renewable Energy"
- "Building a Strong Company Culture"

## 🎯 Use Cases

- Business presentations
- Educational lectures
- Conference talks
- Investor pitches
- Training sessions
- Sales presentations

## 🛠️ Technical Details

- **Model**: Falcon3-1B-Instruct (via HuggingFace Inference API)
- **Framework**: Gradio
- **Deployment**: HuggingFace Spaces
- **No local setup required!**

## 📖 Tips for Best Results

1. **Be specific** with your topic description
2. **Choose appropriate** audience and tone
3. **Use 3-7 slides** for optimal quality
4. **Review and customize** the generated script
5. **Practice** with the suggested timings

## 🎓 Created For

Johns Hopkins University - Agentic AI Certificate Program

Demonstrating practical applications of:
- Large Language Models (LLMs)
- Prompt Engineering
- AI-powered content generation

## 📝 License

MIT License - Free to use for educational and commercial purposes

---

**Powered by Falcon3-1B-Instruct via HuggingFace Inference API** 🤖