Upload 7 files

DEPLOYMENT_GUIDE.md

@@ -0,0 +1,398 @@
+# 🚀 HuggingFace Spaces Deployment Guide
+
+## Quick Deployment Steps
+
+### Option 1: Using HuggingFace Web Interface (Easiest)
+
+1. **Go to HuggingFace Spaces**
+   - Visit: https://huggingface.co/spaces
+   - Click "Create new Space"
+
+2. **Configure Your Space**
+   - **Space name**: `ppt-script-generator` (or your choice)
+   - **License**: MIT
+   - **SDK**: Gradio
+   - **Visibility**: Public (or Private)
+   - Click "Create Space"
+
+3. **Upload Files**
+   - Click "Files" tab
+   - Upload these files:
+     - `app.py`
+     - `requirements_hf.txt` (rename to `requirements.txt` when uploading)
+     - `README_HF.md` (rename to `README.md` when uploading)
+
+4. **Wait for Build**
+   - HuggingFace will automatically build your Space
+   - Takes 1-2 minutes
+   - Status shown at top of page
+
+5. **Access Your App**
+   - Once built, click "App" tab
+   - Your app is live at: `https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator`
+   - Share this URL with anyone!
+
+---
+
+### Option 2: Using Git (For Developers)
+
+1. **Create Space on HuggingFace**
+   - Visit: https://huggingface.co/new-space
+   - Fill in details as above
+
+2. **Clone Repository**
+   ```bash
+   git clone https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator
+   cd ppt-script-generator
+   ```
+
+3. **Add Files**
+   ```bash
+   cp path/to/app.py .
+   cp path/to/requirements_hf.txt requirements.txt
+   cp path/to/README_HF.md README.md
+   ```
+
+4. **Commit and Push**
+   ```bash
+   git add .
+   git commit -m "Initial commit: PPT Script Generator"
+   git push
+   ```
+
+5. **Check Deployment**
+   - Visit your Space URL
+   - Check build logs if needed
+
+---
+
+## 📂 Required Files
+
+Your Space needs exactly 3 files:
+
+### 1. `app.py` (Main Application)
+- Contains the complete Gradio interface
+- Uses HuggingFace Inference API
+- No local model download needed
+
+### 2. `requirements.txt` (Dependencies)
+```
+gradio
+huggingface_hub
+```
+
+### 3. `README.md` (Space Description)
+- Shown on your Space's landing page
+- Must have YAML frontmatter at top
+- Describes your app
+
+---
+
+## ⚙️ Configuration Options
+
+### In README.md Frontmatter
+
+```yaml
+---
+title: PowerPoint Script Generator    # Your app name
+emoji: 🎤                              # Icon for your Space
+colorFrom: purple                      # Gradient start color
+colorTo: blue                          # Gradient end color
+sdk: gradio                            # Always 'gradio'
+sdk_version: 4.44.0                    # Gradio version
+app_file: app.py                       # Main file name
+pinned: false                          # Pin to your profile?
+license: mit                           # License type
+---
+```
+
+### Visibility Options
+
+- **Public**: Anyone can view and use
+- **Private**: Only you (and collaborators) can access
+
+---
+
+## 🔍 Testing Your Deployment
+
+### Before Deploying
+
+Test locally first:
+```bash
+python app.py
+```
+
+Should show:
+```
+Running on local URL:  http://127.0.0.1:7860
+```
+
+### After Deploying
+
+1. **Check Build Status**
+   - Look for green checkmark
+   - If red X, check logs
+
+2. **Test the App**
+   - Try example topics
+   - Test with custom topic
+   - Verify output quality
+
+3. **Common Issues**
+   - **Build fails**: Check requirements.txt
+   - **App crashes**: Check app.py for errors
+   - **Slow generation**: Normal for free tier
+   - **API errors**: Wait and retry (rate limits)
+
+---
+
+## 📊 Usage Limits (Free Tier)
+
+HuggingFace Spaces free tier has:
+- **Compute**: Limited CPU/RAM
+- **API calls**: Rate limited
+- **Uptime**: May sleep after inactivity
+- **Build time**: A few minutes
+
+**For production use**, consider upgrading to a paid tier.
+
+---
+
+## 🎨 Customization After Deployment
+
+### Update Your Space
+
+1. **Via Web Interface**
+   - Go to "Files" tab
+   - Click file to edit
+   - Make changes
+   - Click "Commit changes"
+   - Space rebuilds automatically
+
+2. **Via Git**
+   ```bash
+   # Make changes to files
+   git add .
+   git commit -m "Updated generation prompt"
+   git push
+   ```
+
+### Common Customizations
+
+**Change Model:**
+```python
+self.client = InferenceClient(
+    model="different-model-name",
+    token=os.getenv("HF_TOKEN")
+)
+```
+
+**Adjust Defaults:**
+```python
+num_slides = gr.Slider(
+    minimum=3,
+    maximum=15,  # Changed from 10
+    value=7,     # Changed from 5
+    ...
+)
+```
+
+**Add More Examples:**
+```python
+gr.Examples(
+    examples=[
+        ["Your new topic", 5, "Students", "Educational"],
+        # Add more here
+    ],
+    ...
+)
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Build Errors
+
+**Error: "No module named 'gradio'"**
+- Fix: Check `requirements.txt` has `gradio`
+
+**Error: "Cannot find app.py"**
+- Fix: Ensure `app_file: app.py` in README.md frontmatter
+
+### Runtime Errors
+
+**Error: "API rate limit exceeded"**
+- Wait 60 seconds and try again
+- Consider upgrading Space tier
+
+**Error: "Model timeout"**
+- Normal for long generations
+- Reduce number of slides
+- Reduce max_tokens
+
+**App shows "Sleeping"**
+- Free tier sleeps after inactivity
+- Click to wake it up (takes 10-20 seconds)
+
+---
+
+## 📈 Monitoring Your Space
+
+### Check Analytics
+
+- Visit your Space page
+- Click "Analytics" tab
+- See:
+  - Number of users
+  - Usage patterns
+  - Popular features
+
+### View Logs
+
+- Click "Logs" tab
+- See real-time app output
+- Debug errors
+- Monitor performance
+
+---
+
+## 🔒 Security Best Practices
+
+### API Tokens
+
+- Never hardcode tokens in code
+- Use `os.getenv("HF_TOKEN")`
+- HF Spaces provides this automatically
+
+### Rate Limiting
+
+- Implement client-side delays
+- Show loading messages
+- Handle API errors gracefully
+
+### Input Validation
+
+Already implemented in `app.py`:
+```python
+if not topic.strip():
+    return "⚠️ Please enter a presentation topic."
+```
+
+---
+
+## 🌟 Making Your Space Popular
+
+### 1. Good Description
+- Clear README.md
+- Screenshots/GIFs
+- Use cases
+
+### 2. Example Content
+- Provide good examples
+- Show various use cases
+- Make it easy to try
+
+### 3. Share It
+- Social media
+- GitHub repos
+- Blog posts
+- Communities
+
+### 4. Maintain It
+- Fix bugs quickly
+- Update dependencies
+- Improve based on feedback
+
+---
+
+## 📱 Embedding Your Space
+
+### In a Website
+
+```html
+<gradio-app src="https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator"></gradio-app>
+<script type="module" src="https://gradio.s3-us-west-2.amazonaws.com/4.44.0/gradio.js"></script>
+```
+
+### In a Blog Post
+
+Use the embed code from your Space settings.
+
+---
+
+## 🚀 Next Steps After Deployment
+
+1. **Test thoroughly**
+   - Try various topics
+   - Different audiences
+   - Edge cases
+
+2. **Gather feedback**
+   - Share with users
+   - Collect suggestions
+   - Iterate and improve
+
+3. **Add features**
+   - Export to PDF
+   - Save templates
+   - Multi-language support
+
+4. **Optimize performance**
+   - Cache common requests
+   - Optimize prompts
+   - Reduce token usage
+
+---
+
+## 📞 Getting Help
+
+### Resources
+
+- **HuggingFace Docs**: https://huggingface.co/docs/hub/spaces
+- **Gradio Docs**: https://gradio.app/docs
+- **Community Forum**: https://discuss.huggingface.co
+
+### Common Questions
+
+**Q: How long does deployment take?**
+A: Usually 1-2 minutes for first build
+
+**Q: Can I use private models?**
+A: Yes, with HF Pro subscription
+
+**Q: What's the API rate limit?**
+A: Varies by tier; free tier is limited
+
+**Q: Can I upgrade my Space?**
+A: Yes, upgrade to PRO or Enterprise
+
+---
+
+## ✅ Pre-Deployment Checklist
+
+Before you deploy, ensure:
+
+- [ ] `app.py` runs locally without errors
+- [ ] `requirements.txt` has all dependencies
+- [ ] `README.md` has correct YAML frontmatter
+- [ ] Example topics work correctly
+- [ ] Error handling is in place
+- [ ] Loading messages are shown
+- [ ] Output is properly formatted
+- [ ] All features work as expected
+
+---
+
+## 🎉 You're Ready!
+
+Your Space will be live at:
+```
+https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator
+```
+
+**Share it with the world!** 🌍
+
+---
+
+*Last Updated: January 2026*

HUGGINGFACE_DEPLOYMENT_SUMMARY.md

@@ -0,0 +1,484 @@
+# 🎉 HuggingFace Spaces Deployment Package - Complete
+
+## 🎯 What You Have
+
+A **production-ready PowerPoint Script Generator** that runs on **HuggingFace Spaces** using the **Falcon3-1B-Instruct** model via cloud API.
+
+**Key Advantages:**
+- ✅ No local installation required
+- ✅ No model download needed (~0MB vs 700MB+)
+- ✅ Works on any device with internet
+- ✅ Free to deploy and use
+- ✅ Shareable URL for anyone
+- ✅ Automatic scaling and hosting
+
+---
+
+## 📦 Files for HuggingFace Spaces Deployment
+
+### 🔧 Required Files (3 Total)
+
+Upload these **exact 3 files** to your HuggingFace Space:
+
+1. **`app.py`** (Main Application)
+   - Complete Gradio web interface
+   - Uses HuggingFace Inference API
+   - No local model needed
+   - ~250 lines of production code
+
+2. **`requirements.txt`** (Dependencies)
+   - Upload: `requirements_hf.txt`
+   - **Rename to**: `requirements.txt` when uploading
+   - Contents:
+     ```
+     gradio
+     huggingface_hub
+     ```
+
+3. **`README.md`** (Space Description)
+   - Upload: `README_HF.md`
+   - **Rename to**: `README.md` when uploading
+   - Has YAML frontmatter for Space configuration
+
+### 📚 Documentation Files (3 Total)
+
+For your reference (don't upload these to HuggingFace):
+
+4. **`QUICKSTART_HF.md`** - 5-minute deployment guide
+5. **`DEPLOYMENT_GUIDE.md`** - Comprehensive deployment instructions
+6. **`test_hf_app.py`** - Local testing script
+
+---
+
+## 🚀 Deployment Steps (Ultra Quick)
+
+### 5-Minute Deployment:
+
+```bash
+1. Go to: https://huggingface.co/new-space
+2. Create Space:
+   - Name: ppt-script-generator
+   - SDK: Gradio
+   - Hardware: CPU basic (free)
+3. Upload 3 files:
+   - app.py (as is)
+   - requirements_hf.txt → rename to requirements.txt
+   - README_HF.md → rename to README.md
+4. Click "Commit changes"
+5. Wait 1-2 minutes for build
+6. Done! Your app is live!
+```
+
+**Your URL will be:**
+```
+https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator
+```
+
+---
+
+## ✨ Key Features of Your App
+
+### User Features:
+- 📝 Enter any presentation topic
+- 📊 Choose 3-10 slides
+- 👥 8 audience types (students, executives, technical, etc.)
+- 🎨 6 tone options (professional, casual, inspirational, etc.)
+- ⚙️ Advanced controls (temperature, max tokens)
+- 💡 5 pre-loaded example topics
+- 📋 One-click copy of generated scripts
+
+### Technical Features:
+- 🤖 Uses Falcon3-1B-Instruct via HuggingFace API
+- 🎨 Beautiful Gradio interface
+- ☁️ 100% cloud-based (no local setup)
+- 🔒 No API key management (HF handles it)
+- ⚡ Fast generation (10-30 seconds)
+- 📱 Mobile-friendly responsive design
+
+---
+
+## 📊 What Each Slide Script Includes
+
+```yaml
+For Each Slide:
+  - Title: Clear, descriptive heading
+  - Speaker Script: 2-4 complete sentences
+  - Key Points: 3-4 bullet points
+  - Timing: Suggested duration (seconds)
+```
+
+**Example Output:**
+
+```
+---
+Slide 1: Introduction to Cloud Computing
+
+Speaker Script:
+Welcome everyone. Today we'll explore cloud computing, a 
+technology that's revolutionizing how businesses operate. 
+Cloud computing allows companies to access computing resources 
+over the internet, eliminating the need for expensive on-premises 
+infrastructure.
+
+Key Points:
+- Access computing resources via internet
+- No need for physical infrastructure
+- Pay-as-you-go pricing model
+- Scalable and flexible
+
+Timing: 50 seconds
+
+---
+```
+
+---
+
+## 🔍 Comparison: Local vs HuggingFace Versions
+
+| Feature | Local Version | HuggingFace Spaces |
+|---------|---------------|-------------------|
+| **Model Storage** | 700MB local download | 0MB (cloud API) |
+| **Setup Time** | 5-10 minutes | 2-3 minutes |
+| **Requirements** | Python, packages, model | Just upload 3 files |
+| **Access** | Local only | Anywhere with internet |
+| **Sharing** | Complex | Just share URL |
+| **Hardware** | Your computer | HF servers |
+| **Cost** | Free (uses your resources) | Free (HF tier) |
+| **Speed** | Depends on your CPU | Depends on API load |
+| **Maintenance** | You manage | HF manages |
+| **Best For** | Learning, offline use | Production, sharing |
+
+**Recommendation**: Use **HuggingFace Spaces** for:
+- Portfolio projects
+- Sharing with others
+- Production demos
+- No-installation required scenarios
+
+Use **Local version** for:
+- Learning prompt engineering
+- Offline development
+- Custom model experimentation
+- Full control over resources
+
+---
+
+## 🎯 Use Cases
+
+### Perfect For:
+
+1. **Business Presentations**
+   - Sales pitches
+   - Quarterly reviews
+   - Strategy sessions
+   - Board meetings
+
+2. **Educational Content**
+   - Lectures
+   - Training materials
+   - Workshops
+   - Tutorials
+
+3. **Technical Talks**
+   - Conference presentations
+   - Technical deep-dives
+   - Architecture reviews
+   - Product demos
+
+4. **Investor Pitches**
+   - Fundraising presentations
+   - Startup pitches
+   - Business plans
+   - Growth strategies
+
+5. **Training Sessions**
+   - Employee onboarding
+   - Skill development
+   - Compliance training
+   - Product training
+
+---
+
+## 💡 Example Scenarios
+
+### Scenario 1: Business Executive
+
+**Input:**
+- Topic: "Q1 2025 Sales Performance and Q2 Strategy"
+- Slides: 6
+- Audience: Business executives
+- Tone: Professional
+
+**Gets:**
+- Executive-focused scripts
+- Metrics and KPIs highlighted
+- Strategic language
+- Action-oriented content
+
+---
+
+### Scenario 2: Teacher
+
+**Input:**
+- Topic: "Introduction to Photosynthesis"
+- Slides: 5
+- Audience: Students
+- Tone: Educational
+
+**Gets:**
+- Simple, clear explanations
+- Step-by-step progression
+- Relatable examples
+- Engaging content
+
+---
+
+### Scenario 3: Developer
+
+**Input:**
+- Topic: "Microservices Architecture Best Practices"
+- Slides: 8
+- Audience: Technical professionals
+- Tone: Technical and detailed
+
+**Gets:**
+- Technical depth
+- Implementation details
+- Best practices
+- Code examples mentioned
+
+---
+
+## 🧪 Testing Before Deployment
+
+Run the test script locally:
+
+```bash
+python test_hf_app.py
+```
+
+**Expected Output:**
+```
+🔍 HUGGINGFACE SPACES APP - PRE-DEPLOYMENT TEST
+================================================================================
+
+Testing Package Imports...
+✅ Gradio UI Framework: INSTALLED
+✅ HuggingFace Hub Client: INSTALLED
+
+Testing app.py File...
+✅ app.py file exists
+✅ app.py is valid Python code
+✅ PPTScriptGenerator class found
+✅ create_gradio_interface function found
+✅ InferenceClient usage found
+
+[... more tests ...]
+
+🎉 All tests passed! Your app is ready to deploy to HuggingFace Spaces!
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Common Issues:
+
+**"Build Failed"**
+- Check file names are exact: `app.py`, `requirements.txt`, `README.md`
+- Verify YAML frontmatter in README.md
+- Check Logs tab for specific error
+
+**"API Rate Limit"**
+- Normal for free tier during high load
+- Wait 60 seconds and retry
+- Reduce number of slides
+- Try off-peak hours
+
+**"Space Sleeping"**
+- Free tier sleeps after 30 min inactivity
+- Click to wake (10-20 seconds)
+- Upgrade to HF Pro to prevent sleeping
+
+**"Slow Generation"**
+- Normal during high API load
+- Reduce max_tokens to 1500
+- Reduce slides to 3-5
+- Try different times of day
+
+---
+
+## 🎓 Educational Value
+
+This project demonstrates:
+
+### For Your Agentic AI Program:
+
+1. **✅ LLM Integration**
+   - Using cloud-based inference APIs
+   - Understanding API vs local models
+   - Managing API calls and errors
+
+2. **✅ Prompt Engineering**
+   - Structured prompt design
+   - Role-based prompting
+   - Output format specification
+   - Parameter tuning
+
+3. **✅ Application Development**
+   - Building user-friendly interfaces
+   - Error handling and validation
+   - User experience design
+   - Production deployment
+
+4. **✅ Cloud Infrastructure**
+   - Deploying to cloud platforms
+   - Managing dependencies
+   - Configuration management
+   - Continuous deployment
+
+5. **✅ Real-World Application**
+   - Solving actual business problems
+   - User-centered design
+   - Practical AI implementation
+   - Portfolio-worthy project
+
+---
+
+## 📈 Next Steps After Deployment
+
+### Immediate:
+1. ✅ Test with various topics
+2. ✅ Share with colleagues/classmates
+3. ✅ Add to your portfolio
+4. ✅ Gather feedback
+
+### Short-term:
+1. Customize example topics
+2. Adjust default settings
+3. Monitor usage analytics
+4. Iterate based on feedback
+
+### Long-term:
+1. Add export functionality (PDF/DOCX)
+2. Implement template saving
+3. Add multi-language support
+4. Build mobile-optimized version
+
+---
+
+## 🌟 Making It Stand Out
+
+### Portfolio Tips:
+
+1. **Documentation**
+   - Include screenshots in README
+   - Add demo GIF
+   - Write clear use cases
+
+2. **Examples**
+   - Show diverse topics
+   - Demonstrate different audiences
+   - Highlight quality outputs
+
+3. **Sharing**
+   - Blog post about development
+   - LinkedIn post with demo
+   - GitHub repo with code
+   - Video walkthrough
+
+4. **Improvements**
+   - Gather user feedback
+   - Add requested features
+   - Keep dependencies updated
+   - Monitor and fix issues
+
+---
+
+## ✅ Pre-Deployment Checklist
+
+Before deploying, ensure:
+
+- [ ] All 3 files ready (app.py, requirements.txt, README.md)
+- [ ] Files named correctly
+- [ ] README has YAML frontmatter
+- [ ] Test script passes locally
+- [ ] Example topics work
+- [ ] Error handling in place
+- [ ] Loading messages shown
+- [ ] HuggingFace account created
+- [ ] Understand how to upload files
+
+---
+
+## 🎉 Summary
+
+### What You've Built:
+
+A **professional, cloud-deployed AI application** that:
+- Generates PowerPoint scripts instantly
+- Works for any topic
+- Customizes for different audiences
+- Runs entirely in the cloud
+- Costs $0 to deploy and use
+- Can be shared with anyone
+- Requires no installation
+
+### Time Investment:
+- **Development**: Already done! ✅
+- **Deployment**: 5 minutes
+- **Testing**: 2 minutes
+- **Total**: < 10 minutes to go live
+
+### Technologies Used:
+- Falcon3-1B-Instruct (TII)
+- HuggingFace Inference API
+- Gradio (UI framework)
+- HuggingFace Spaces (hosting)
+- Python 3.8+
+
+---
+
+## 📞 Support
+
+### If You Need Help:
+
+**Documentation:**
+- `QUICKSTART_HF.md` - Fast deployment guide
+- `DEPLOYMENT_GUIDE.md` - Detailed instructions
+- `test_hf_app.py` - Test your setup
+
+**External Resources:**
+- HuggingFace Docs: https://huggingface.co/docs/hub/spaces
+- Gradio Guide: https://gradio.app/docs
+- Community: https://discuss.huggingface.co
+
+**Test Locally First:**
+```bash
+python test_hf_app.py
+```
+
+---
+
+## 🎯 Your Deployment URL
+
+After deployment, your app will be at:
+
+```
+https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator
+```
+
+**Share it everywhere!** 🌍
+
+---
+
+**Built for: Johns Hopkins University Agentic AI Certificate Program** 🎓  
+**Demonstrates: Caselet 4 from HuggingFace Prompt Engineering Lab** 📚  
+**Status: Production Ready** ✅  
+**Cost: $0** 💰  
+**Time to Deploy: < 5 minutes** ⚡
+
+---
+
+*Last Updated: January 2026*  
+*Version: HuggingFace Spaces Edition*  
+*Ready to Deploy!* 🚀

QUICKSTART_HF.md

@@ -0,0 +1,347 @@
+# 🚀 Quick Start: Deploy to HuggingFace Spaces in 5 Minutes
+
+## What You're Deploying
+
+A **PowerPoint Script Generator** that uses AI to create presentation scripts for any topic.
+
+**No installation required!** Everything runs in the cloud on HuggingFace Spaces.
+
+---
+
+## ⚡ Super Fast Deployment (3 Steps)
+
+### Step 1: Create a HuggingFace Account (if needed)
+
+1. Go to https://huggingface.co/join
+2. Sign up (free!)
+3. Verify your email
+
+### Step 2: Create a New Space
+
+1. Go to https://huggingface.co/new-space
+2. Fill in:
+   - **Owner**: Your username
+   - **Space name**: `ppt-script-generator`
+   - **License**: MIT
+   - **Select SDK**: Choose **Gradio**
+   - **Space hardware**: CPU basic (free)
+   - **Visibility**: Public
+3. Click **"Create Space"**
+
+### Step 3: Upload Your Files
+
+You need to upload 3 files:
+
+1. **Click "Files and versions"** tab
+2. **Click "Add file" → "Upload files"**
+3. **Upload these 3 files:**
+
+   📄 **File 1: `app.py`**
+   - Upload the `app.py` file from this package
+
+   📄 **File 2: `requirements.txt`**
+   - Upload `requirements_hf.txt` 
+   - **IMPORTANT**: Rename it to `requirements.txt` when uploading
+
+   📄 **File 3: `README.md`**
+   - Upload `README_HF.md`
+   - **IMPORTANT**: Rename it to `README.md` when uploading
+
+4. **Click "Commit changes to main"**
+
+### Step 4: Wait for Build
+
+- HuggingFace automatically builds your Space (takes 1-2 minutes)
+- You'll see a progress indicator
+- When complete, you'll see "App" tab become active
+
+### Step 5: Use Your App!
+
+- Click the **"App"** tab
+- Your app is now live!
+- Share the URL: `https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator`
+
+---
+
+## 🎯 Using Your App
+
+### Try It Out
+
+1. **Enter a topic**: e.g., "The Future of Renewable Energy"
+2. **Set number of slides**: e.g., 5
+3. **Choose audience**: e.g., "Business executives"
+4. **Select tone**: e.g., "Professional"
+5. **Click "Generate Presentation Script"**
+6. **Wait 10-30 seconds** for AI to generate
+7. **Copy the script** and use it!
+
+### Example Input/Output
+
+**Input:**
+```
+Topic: Introduction to Artificial Intelligence
+Slides: 5
+Audience: Students
+Tone: Educational
+```
+
+**Output:**
+```
+---
+Slide 1: What is Artificial Intelligence?
+
+Speaker Script:
+Welcome everyone! Today we're diving into the fascinating world 
+of Artificial Intelligence. AI is the science of making computers 
+think and learn like humans do. Imagine teaching a computer to 
+recognize your voice, recommend movies you'll love, or even drive 
+a car - that's all AI!
+
+Key Points:
+- AI makes computers intelligent
+- Mimics human thinking and learning
+- Used in everyday technology
+- Growing field with huge potential
+
+Timing: 45 seconds
+
+---
+
+[... 4 more slides ...]
+```
+
+---
+
+## 📂 File Structure (What You Uploaded)
+
+```
+Your HuggingFace Space:
+│
+├── app.py                 # Main application
+├── requirements.txt       # Python dependencies (gradio, huggingface_hub)
+└── README.md             # Space description (with YAML frontmatter)
+```
+
+---
+
+## ✅ Verification Checklist
+
+After deployment, verify:
+
+- [ ] Build completed successfully (green checkmark)
+- [ ] "App" tab is accessible
+- [ ] Example topics load correctly
+- [ ] Generate button works
+- [ ] Script output appears after 10-30 seconds
+- [ ] Copy button works
+- [ ] All dropdowns function properly
+
+---
+
+## 🐛 Common Issues & Fixes
+
+### Issue 1: Build Failed
+
+**Error**: Red X on build status
+
+**Fix**:
+1. Check "Logs" tab for error message
+2. Common causes:
+   - Wrong file names (must be exact: `app.py`, `requirements.txt`, `README.md`)
+   - Missing YAML frontmatter in README.md
+   - Syntax error in app.py
+
+### Issue 2: "Sleeping" Message
+
+**Status**: App shows "This Space is sleeping"
+
+**Fix**:
+- Normal for free tier after inactivity
+- Click anywhere to wake it up
+- Takes 10-20 seconds to restart
+
+### Issue 3: Generation Fails
+
+**Error**: "API rate limit exceeded" or timeout
+
+**Fix**:
+- Wait 60 seconds and try again
+- Reduce number of slides (try 3-5)
+- Reduce max tokens (try 1500)
+- This is normal during high server load
+
+### Issue 4: Slow Generation
+
+**Status**: Takes > 1 minute to generate
+
+**Fix**:
+- Normal for free tier
+- HuggingFace API might be busy
+- Try off-peak hours
+- Consider upgrading to HF Pro for faster inference
+
+---
+
+## 🎨 Customization (After Deployment)
+
+Want to change something? Easy!
+
+### Change App Title
+
+1. Click "Files and versions"
+2. Click `README.md`
+3. Edit the `title:` line in YAML frontmatter
+4. Commit changes
+5. Space rebuilds automatically
+
+### Change Example Topics
+
+1. Click "Files and versions"
+2. Click `app.py`
+3. Find the `gr.Examples` section
+4. Edit the example list
+5. Commit changes
+
+### Adjust Defaults
+
+In `app.py`, find and modify:
+```python
+num_slides = gr.Slider(
+    minimum=3,
+    maximum=10,
+    value=5,      # Change this default
+    ...
+)
+```
+
+---
+
+## 📊 Monitor Your Space
+
+### View Analytics
+
+1. Go to your Space page
+2. Click "Analytics" tab
+3. See:
+   - Total users
+   - Active users
+   - Usage patterns
+
+### Check Logs
+
+1. Click "Logs" tab
+2. See real-time output
+3. Debug any issues
+
+---
+
+## 🔗 Sharing Your Space
+
+Your Space URL:
+```
+https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator
+```
+
+### Share On:
+- Social media (Twitter, LinkedIn)
+- Your website or blog
+- Email signature
+- Portfolio
+- GitHub README
+
+### Embed in Website
+
+```html
+<gradio-app 
+  src="https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator">
+</gradio-app>
+<script 
+  type="module" 
+  src="https://gradio.s3-us-west-2.amazonaws.com/4.44.0/gradio.js">
+</script>
+```
+
+---
+
+## 💡 Tips for Success
+
+### For Best Results:
+
+1. **Be Specific**: 
+   - ✅ "The Impact of AI on Healthcare Diagnostics"
+   - ❌ "AI stuff"
+
+2. **Choose Right Audience**:
+   - Match to who will actually listen
+   - Affects language complexity
+
+3. **Appropriate Tone**:
+   - Professional for business
+   - Educational for students
+   - Technical for engineers
+
+4. **Optimal Slides**:
+   - 3-7 slides work best
+   - More slides = slower generation
+
+5. **Review Output**:
+   - Always customize to your style
+   - Add personal examples
+   - Practice timing
+
+---
+
+## 🎓 What This Demonstrates
+
+This project shows your understanding of:
+
+- ✅ **LLM Deployment**: Using AI models in production
+- ✅ **Prompt Engineering**: Crafting effective prompts
+- ✅ **Cloud Infrastructure**: Deploying to HuggingFace
+- ✅ **UI/UX Design**: Building user-friendly interfaces
+- ✅ **API Integration**: Using HuggingFace Inference API
+- ✅ **Real-world Application**: Solving actual business problems
+
+Perfect for your **Johns Hopkins Agentic AI Certificate** portfolio!
+
+---
+
+## 📞 Need Help?
+
+### Resources:
+- **HuggingFace Docs**: https://huggingface.co/docs/hub/spaces
+- **Gradio Guide**: https://gradio.app/docs
+- **Community Forum**: https://discuss.huggingface.co
+
+### Files Included:
+- `DEPLOYMENT_GUIDE.md` - Detailed deployment instructions
+- `test_hf_app.py` - Test script for local verification
+- `app.py` - Main application code
+- `README_HF.md` - Space description
+
+---
+
+## ✨ You're Done!
+
+**Congratulations!** 🎉 
+
+Your AI-powered PowerPoint Script Generator is now live on HuggingFace Spaces!
+
+**Next steps:**
+1. Test it with different topics
+2. Share the URL with friends/colleagues
+3. Add to your portfolio
+4. Get feedback and iterate
+
+**Your live app:**
+```
+https://huggingface.co/spaces/YOUR_USERNAME/ppt-script-generator
+```
+
+---
+
+**Time to deploy: < 5 minutes** ⚡  
+**Cost: $0 (completely free!)** 💰  
+**Accessibility: Anyone, anywhere** 🌍
+
+**Built for: Johns Hopkins Agentic AI Program** 🎓

README_HF.md

@@ -0,0 +1,93 @@
+---
+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** 🤖

app.py

@@ -0,0 +1,343 @@
+"""
+PowerPoint Script Generator for HuggingFace Spaces
+Uses HuggingFace Inference API - No local model download required!
+"""
+
+import gradio as gr
+from huggingface_hub import InferenceClient
+import os
+import time
+
+# ============================================================================
+# HUGGINGFACE INFERENCE CLIENT SETUP
+# ============================================================================
+
+class PPTScriptGenerator:
+    """Handles script generation using HuggingFace Inference API"""
+    
+    def __init__(self):
+        """Initialize the inference client"""
+        # Using the Inference API - no local model needed!
+        self.client = InferenceClient(
+            model="tiiuae/Falcon3-1B-Instruct",
+            token=os.getenv("HF_TOKEN")  # HF Spaces automatically provides this
+        )
+        print("✅ Inference client initialized")
+    
+    def create_prompt(self, topic, num_slides, audience="General audience", tone="Professional"):
+        """
+        Create a structured prompt for PPT script generation
+        
+        Args:
+            topic: The presentation topic
+            num_slides: Number of slides to generate scripts for
+            audience: Target audience
+            tone: Presentation tone
+        
+        Returns:
+            Formatted prompt string
+        """
+        prompt = f"""You are an expert presentation script writer. Your goal is to create engaging, clear, and well-structured speaker notes for a PowerPoint presentation.
+
+**Presentation Topic**: {topic}
+**Number of Slides**: {num_slides}
+**Target Audience**: {audience}
+**Tone**: {tone}
+
+**Instructions**:
+1. Generate a complete script for each slide in the presentation
+2. Each slide should have:
+   - A clear slide title
+   - Detailed speaker notes (2-4 sentences)
+   - Key talking points (3-4 bullet points)
+   - Suggested timing in seconds
+
+3. Ensure smooth transitions between slides
+4. Make the content engaging and appropriate for the target audience
+5. Use the specified tone throughout
+
+**Output Format**:
+For each slide, provide:
+
+---
+**Slide [Number]: [Title]**
+
+**Speaker Script**:
+[Detailed script with 2-4 sentences that the presenter should say]
+
+**Key Points**:
+- [Point 1]
+- [Point 2]
+- [Point 3]
+
+**Timing**: [Suggested time in seconds]
+
+---
+
+Begin generating the presentation script now:"""
+        
+        return prompt
+    
+    def generate_script(self, topic, num_slides=5, audience="General audience", 
+                       tone="Professional", temperature=0.7, max_tokens=2000):
+        """
+        Generate the PPT script using HuggingFace Inference API
+        
+        Args:
+            topic: Presentation topic
+            num_slides: Number of slides
+            audience: Target audience
+            tone: Presentation tone
+            temperature: Sampling temperature (0.0-1.0)
+            max_tokens: Maximum tokens to generate
+        
+        Returns:
+            Generated script as string
+        """
+        if not topic or not topic.strip():
+            return "⚠️ Please enter a presentation topic."
+        
+        try:
+            prompt = self.create_prompt(topic, num_slides, audience, tone)
+            
+            # Generate using the Inference API
+            response = self.client.text_generation(
+                prompt,
+                max_new_tokens=max_tokens,
+                temperature=temperature,
+                top_p=0.9,
+                repetition_penalty=1.1,
+                do_sample=True,
+                return_full_text=False
+            )
+            
+            return response.strip()
+            
+        except Exception as e:
+            error_msg = f"❌ Error generating script: {str(e)}\n\n"
+            error_msg += "💡 This might be due to:\n"
+            error_msg += "- High server load (try again in a moment)\n"
+            error_msg += "- Topic complexity (try a simpler topic)\n"
+            error_msg += "- Token limit exceeded (reduce number of slides)\n"
+            return error_msg
+
+
+# ============================================================================
+# GRADIO INTERFACE FOR HUGGINGFACE SPACES
+# ============================================================================
+
+def create_gradio_interface():
+    """Create the Gradio UI optimized for HuggingFace Spaces"""
+    
+    # Initialize the generator
+    generator = PPTScriptGenerator()
+    
+    # Welcome message
+    welcome_html = """
+    <div style="text-align: center; padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 10px; margin-bottom: 20px;">
+        <h1 style="color: white; margin: 0; font-size: 2.5em;">🎤 PowerPoint Script Generator</h1>
+        <p style="color: #f0f0f0; font-size: 1.2em; margin-top: 10px;">
+            Powered by Falcon3-1B-Instruct
+        </p>
+        <p style="color: #e0e0e0; font-size: 0.9em; margin-top: 5px;">
+            Generate professional presentation scripts in seconds ✨
+        </p>
+    </div>
+    """
+    
+    # Instructions
+    instructions_html = """
+    <div style="background: #f8f9fa; padding: 15px; border-radius: 8px; margin-bottom: 20px; border-left: 4px solid #667eea;">
+        <h3 style="margin-top: 0; color: #667eea;">📋 How to Use:</h3>
+        <ol style="margin-bottom: 0;">
+            <li><strong>Enter your topic</strong> - Be specific about what you want to present</li>
+            <li><strong>Choose number of slides</strong> - Select 3-10 slides</li>
+            <li><strong>Select audience & tone</strong> - Customize for your needs</li>
+            <li><strong>Click Generate</strong> - Wait 10-30 seconds for your script</li>
+        </ol>
+    </div>
+    """
+    
+    def generate_wrapper(topic, num_slides, audience, tone, temperature, max_tokens):
+        """Wrapper function for Gradio"""
+        if not topic.strip():
+            return "⚠️ Please enter a presentation topic."
+        
+        # Show generating message
+        yield "🔄 Generating your presentation script...\n\nThis may take 10-30 seconds depending on server load.\n\nPlease wait..."
+        
+        # Generate script
+        script = generator.generate_script(
+            topic=topic,
+            num_slides=num_slides,
+            audience=audience,
+            tone=tone,
+            temperature=temperature,
+            max_tokens=max_tokens
+        )
+        
+        yield script
+    
+    # Create Gradio interface
+    with gr.Blocks(theme=gr.themes.Soft(), title="PPT Script Generator") as demo:
+        
+        gr.HTML(welcome_html)
+        gr.HTML(instructions_html)
+        
+        with gr.Row():
+            with gr.Column(scale=1):
+                gr.Markdown("### 📝 Input Configuration")
+                
+                # Main inputs
+                topic_input = gr.Textbox(
+                    label="📌 Presentation Topic",
+                    placeholder="e.g., Introduction to Artificial Intelligence in Healthcare",
+                    lines=3,
+                    info="Enter the main topic of your presentation"
+                )
+                
+                num_slides = gr.Slider(
+                    minimum=3,
+                    maximum=10,
+                    value=5,
+                    step=1,
+                    label="📊 Number of Slides",
+                    info="How many slides do you need scripts for?"
+                )
+                
+                audience = gr.Dropdown(
+                    choices=[
+                        "General audience",
+                        "Business executives",
+                        "Technical professionals",
+                        "Students",
+                        "Healthcare professionals",
+                        "Marketing professionals",
+                        "Investors",
+                        "Academic researchers"
+                    ],
+                    value="General audience",
+                    label="👥 Target Audience",
+                    info="Who will be listening to this presentation?"
+                )
+                
+                tone = gr.Dropdown(
+                    choices=[
+                        "Professional",
+                        "Casual and friendly",
+                        "Technical and detailed",
+                        "Inspirational",
+                        "Educational",
+                        "Persuasive"
+                    ],
+                    value="Professional",
+                    label="🎨 Presentation Tone",
+                    info="What style should the script have?"
+                )
+                
+                # Advanced settings
+                with gr.Accordion("⚙️ Advanced Generation Settings", open=False):
+                    temperature = gr.Slider(
+                        minimum=0.3,
+                        maximum=0.9,
+                        value=0.7,
+                        step=0.1,
+                        label="🌡️ Temperature",
+                        info="Higher = more creative, Lower = more focused"
+                    )
+                    
+                    max_tokens = gr.Slider(
+                        minimum=1000,
+                        maximum=3000,
+                        value=2000,
+                        step=100,
+                        label="📏 Max Tokens",
+                        info="Maximum length of generated script"
+                    )
+                
+                # Generate button
+                generate_btn = gr.Button(
+                    "🚀 Generate Presentation Script",
+                    variant="primary",
+                    size="lg"
+                )
+                
+                # Example topics
+                gr.Markdown("### 💡 Example Topics:")
+                gr.Examples(
+                    examples=[
+                        ["The Future of Renewable Energy", 5, "Business executives", "Professional"],
+                        ["Introduction to Machine Learning", 7, "Students", "Educational"],
+                        ["Quarterly Sales Performance Review", 4, "Business executives", "Professional"],
+                        ["Cybersecurity Best Practices for Small Businesses", 6, "Technical professionals", "Technical and detailed"],
+                        ["Building a Strong Company Culture", 5, "Business executives", "Inspirational"]
+                    ],
+                    inputs=[topic_input, num_slides, audience, tone],
+                    label="Click any example to load it"
+                )
+            
+            with gr.Column(scale=1):
+                gr.Markdown("### 📄 Generated Script")
+                
+                output = gr.Textbox(
+                    label="Presentation Script",
+                    lines=30,
+                    max_lines=35,
+                    show_copy_button=True,
+                    placeholder="Your generated presentation script will appear here...\n\n⏱️ Generation typically takes 10-30 seconds.",
+                    info="Copy this script and use it for your presentation!"
+                )
+                
+                # Tips section
+                with gr.Accordion("💡 Tips for Best Results", open=False):
+                    gr.Markdown("""
+                    **Best Practices:**
+                    - 📖 Be specific in your topic description
+                    - 🎯 Choose appropriate audience and tone
+                    - ⏱️ Use 3-7 slides for best results
+                    - 🔄 Try different temperatures for variety
+                    - ✏️ Review and customize the output
+                    - 🎤 Practice with the suggested timings
+                    
+                    **If generation fails:**
+                    - Wait a moment and try again (server might be busy)
+                    - Simplify your topic
+                    - Reduce number of slides
+                    - Lower max tokens to 1500
+                    """)
+        
+        # Connect the button to the function
+        generate_btn.click(
+            fn=generate_wrapper,
+            inputs=[topic_input, num_slides, audience, tone, temperature, max_tokens],
+            outputs=output
+        )
+        
+        # Footer
+        gr.Markdown("""
+        ---
+        <div style="text-align: center; color: #666; font-size: 0.9em;">
+            <p>🤖 Powered by <strong>Falcon3-1B-Instruct</strong> via HuggingFace Inference API</p>
+            <p>Built with ❤️ using Gradio | No local model download required!</p>
+        </div>
+        """)
+    
+    return demo
+
+
+# ============================================================================
+# MAIN EXECUTION
+# ============================================================================
+
+if __name__ == "__main__":
+    print("="*80)
+    print("🎤 PowerPoint Script Generator - HuggingFace Spaces Version")
+    print("="*80)
+    print("\n🚀 Launching Gradio interface...")
+    print("="*80)
+    
+    # Create and launch the interface
+    demo = create_gradio_interface()
+    
+    # Launch - HuggingFace Spaces will handle the hosting
+    demo.launch()

requirements.txt

@@ -0,0 +1,2 @@
+gradio
+huggingface_hub

test_hf_app.py

@@ -0,0 +1,249 @@
+#!/usr/bin/env python3
+"""
+Local Test Script for HuggingFace Spaces App
+Tests the app.py before deploying to HuggingFace
+"""
+
+import sys
+import os
+
+def test_imports():
+    """Test if required packages are available"""
+    print("="*80)
+    print("Testing Package Imports...")
+    print("="*80)
+    
+    required_packages = {
+        'gradio': 'Gradio UI Framework',
+        'huggingface_hub': 'HuggingFace Hub Client'
+    }
+    
+    all_passed = True
+    
+    for package, description in required_packages.items():
+        try:
+            __import__(package)
+            print(f"✅ {description}: INSTALLED")
+        except ImportError:
+            print(f"❌ {description}: NOT FOUND")
+            print(f"   Install with: pip install {package}")
+            all_passed = False
+    
+    return all_passed
+
+
+def test_app_file():
+    """Test if app.py exists and is valid Python"""
+    print("\n" + "="*80)
+    print("Testing app.py File...")
+    print("="*80)
+    
+    if not os.path.exists('app.py'):
+        print("❌ app.py not found in current directory")
+        print("   Make sure you're in the correct folder")
+        return False
+    
+    print("✅ app.py file exists")
+    
+    # Try to parse it
+    try:
+        with open('app.py', 'r') as f:
+            code = f.read()
+        
+        compile(code, 'app.py', 'exec')
+        print("✅ app.py is valid Python code")
+        
+        # Check for key components
+        if 'PPTScriptGenerator' in code:
+            print("✅ PPTScriptGenerator class found")
+        else:
+            print("⚠️  Warning: PPTScriptGenerator class not found")
+        
+        if 'create_gradio_interface' in code:
+            print("✅ create_gradio_interface function found")
+        else:
+            print("⚠️  Warning: create_gradio_interface function not found")
+        
+        if 'InferenceClient' in code:
+            print("✅ InferenceClient usage found")
+        else:
+            print("⚠️  Warning: InferenceClient not found")
+        
+        return True
+        
+    except SyntaxError as e:
+        print(f"❌ Syntax error in app.py: {e}")
+        return False
+
+
+def test_requirements():
+    """Test if requirements file exists"""
+    print("\n" + "="*80)
+    print("Testing Requirements File...")
+    print("="*80)
+    
+    req_files = ['requirements_hf.txt', 'requirements.txt']
+    found = False
+    
+    for req_file in req_files:
+        if os.path.exists(req_file):
+            print(f"✅ {req_file} found")
+            with open(req_file, 'r') as f:
+                content = f.read()
+            print(f"   Contents:\n{content}")
+            found = True
+            break
+    
+    if not found:
+        print("❌ No requirements file found")
+        print("   Need either requirements_hf.txt or requirements.txt")
+        return False
+    
+    return True
+
+
+def test_readme():
+    """Test if README exists"""
+    print("\n" + "="*80)
+    print("Testing README File...")
+    print("="*80)
+    
+    readme_files = ['README_HF.md', 'README.md']
+    found = False
+    
+    for readme in readme_files:
+        if os.path.exists(readme):
+            print(f"✅ {readme} found")
+            with open(readme, 'r') as f:
+                first_lines = ''.join(f.readlines()[:10])
+            
+            if '---' in first_lines and 'title:' in first_lines:
+                print("✅ YAML frontmatter detected")
+            else:
+                print("⚠️  Warning: YAML frontmatter not found (needed for HF Spaces)")
+            
+            found = True
+            break
+    
+    if not found:
+        print("⚠️  Warning: README file not found (recommended for HF Spaces)")
+    
+    return True  # Not critical
+
+
+def test_app_launch():
+    """Test if app can be imported and launched"""
+    print("\n" + "="*80)
+    print("Testing App Launch...")
+    print("="*80)
+    
+    try:
+        # Try importing the app
+        import app as app_module
+        print("✅ app.py imported successfully")
+        
+        # Check if it has the expected components
+        if hasattr(app_module, 'PPTScriptGenerator'):
+            print("✅ PPTScriptGenerator class accessible")
+            
+            # Try instantiating
+            try:
+                generator = app_module.PPTScriptGenerator()
+                print("✅ PPTScriptGenerator instantiated")
+            except Exception as e:
+                print(f"⚠️  Warning: Could not instantiate PPTScriptGenerator: {e}")
+                print("   (This might be okay - could need HF_TOKEN)")
+        
+        if hasattr(app_module, 'create_gradio_interface'):
+            print("✅ create_gradio_interface function accessible")
+        
+        return True
+        
+    except Exception as e:
+        print(f"❌ Error importing app.py: {e}")
+        return False
+
+
+def test_gradio_creation():
+    """Test if Gradio interface can be created"""
+    print("\n" + "="*80)
+    print("Testing Gradio Interface Creation...")
+    print("="*80)
+    
+    try:
+        import app as app_module
+        
+        demo = app_module.create_gradio_interface()
+        print("✅ Gradio interface created successfully")
+        
+        print("\n💡 You can now launch the app locally with:")
+        print("   python app.py")
+        print("\n   Or test in this session:")
+        print("   >>> import app")
+        print("   >>> demo = app.create_gradio_interface()")
+        print("   >>> demo.launch()")
+        
+        return True
+        
+    except Exception as e:
+        print(f"❌ Error creating Gradio interface: {e}")
+        return False
+
+
+def main():
+    """Run all tests"""
+    print("\n" + "🔍 HUGGINGFACE SPACES APP - PRE-DEPLOYMENT TEST")
+    print("="*80)
+    print("")
+    
+    results = {
+        'imports': test_imports(),
+        'app_file': test_app_file(),
+        'requirements': test_requirements(),
+        'readme': test_readme(),
+        'app_launch': test_app_launch(),
+        'gradio_creation': test_gradio_creation()
+    }
+    
+    # Summary
+    print("\n" + "="*80)
+    print("TEST SUMMARY")
+    print("="*80)
+    
+    passed = sum(1 for v in results.values() if v)
+    total = len(results)
+    
+    for test_name, result in results.items():
+        status = "✅ PASSED" if result else "❌ FAILED"
+        print(f"{test_name.upper():25s}: {status}")
+    
+    print("="*80)
+    print(f"Results: {passed}/{total} tests passed")
+    
+    if passed == total:
+        print("\n🎉 All tests passed! Your app is ready to deploy to HuggingFace Spaces!")
+        print("\n📋 Next Steps:")
+        print("   1. Go to https://huggingface.co/new-space")
+        print("   2. Create a new Space with SDK: Gradio")
+        print("   3. Upload these files:")
+        print("      - app.py")
+        print("      - requirements_hf.txt (rename to requirements.txt)")
+        print("      - README_HF.md (rename to README.md)")
+        print("   4. Wait for build (1-2 minutes)")
+        print("   5. Your app will be live!")
+        print("\n   See DEPLOYMENT_GUIDE.md for detailed instructions")
+    else:
+        print("\n⚠️  Some tests failed. Please fix the errors above before deploying.")
+        print("   Common fixes:")
+        print("   - Install missing packages: pip install gradio huggingface_hub")
+        print("   - Ensure app.py is in current directory")
+        print("   - Check for syntax errors in app.py")
+    
+    print("="*80)
+    
+    return passed == total
+
+
+if __name__ == "__main__":
+    success = main()
+    sys.exit(0 if success else 1)