File size: 3,698 Bytes
7b84343 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 | # 🎉 Party Planner - Guest Table Arranger
A smart web application that helps you organize your guest list into optimal table arrangements for networking events and parties. Built with Gradio and deployed on Hugging Face Spaces.
## ✨ Features
- 📁 **Easy CSV Upload**: Simply paste your CSV content or upload a file
- 🧠 **Smart Table Arrangement**: AI-powered algorithm that categorizes guests by industry/role
- 🎯 **Optimal Distribution**: Automatically creates tables of 10 with balanced industry mix
- 📊 **Visual Results**: Clear, formatted output showing table assignments
- 🎨 **Modern Interface**: Beautiful, responsive Gradio interface
- 📱 **Mobile Friendly**: Works perfectly on all devices
## 🚀 How to Use
1. **Prepare Your CSV**: Create a CSV file with exactly 2 columns:
- **First column**: Guest names
- **Second column**: Job titles, roles, or descriptions
2. **Upload Your Data**:
- Paste your CSV content directly into the text box, OR
- Upload your CSV file using the file upload button
3. **Arrange Tables**: Click the "🎯 Arrange Tables" button to see the smart arrangement
4. **View Results**: See your guests organized into optimal table seating with industry-balanced distribution
## 📄 CSV Format Example
```csv
name,message
John Smith,Software Engineer at TechCorp
Sarah Johnson,Marketing Director at Creative Agency
Michael Brown,CEO of StartupXYZ
Emily Davis,Data Scientist at AI Labs
David Wilson,Product Manager at Innovation Inc
```
## 🧠 Smart Categorization
The app automatically categorizes guests based on their job descriptions:
- **Tech**: engineer, developer, programmer, software, tech, data, AI, ML, scientist
- **Business**: manager, director, CEO, founder, executive, strategy, operations, consultant
- **Creative**: designer, creative, marketing, content, writer, artist, media
- **Sales**: sales, account, client, business development, partnership
- **Finance**: finance, accounting, investment, banking, analyst, CFO
- **Other**: any roles not matching the above categories
## 🎯 Table Arrangement Algorithm
1. **Categorizes** guests by industry/role type
2. **Distributes** major categories evenly across tables
3. **Balances** table sizes (maximum 10 guests per table)
4. **Creates** unlimited tables as needed
5. **Ensures** diverse networking opportunities
## 📊 Sample Output
```
🎉 Successfully processed 25 guests!
📊 Created 3 table(s) with smart distribution:
🍽️ **Table 1** (9 guests):
1. **John Smith** - Software Engineer at TechCorp
2. **Sarah Johnson** - Marketing Director at Creative Agency
3. **Michael Brown** - CEO of StartupXYZ
...
🍽️ **Table 2** (8 guests):
1. **Emily Davis** - Data Scientist at AI Labs
2. **David Wilson** - Product Manager at Innovation Inc
...
🍽️ **Table 3** (8 guests):
1. **Lisa Chen** - UX Designer at Design Studio
...
📈 **Table Statistics:**
Table 1: 9 guests
Table 2: 8 guests
Table 3: 8 guests
```
## 🛠️ Technical Details
- **Framework**: Gradio (Python)
- **Algorithm**: Smart categorization and distribution
- **Deployment**: Hugging Face Spaces
- **Dependencies**: gradio>=4.0.0
## 🎨 Features
- **Drag & Drop**: Easy file upload
- **Real-time Processing**: Instant table arrangement
- **Error Handling**: Clear error messages for invalid formats
- **Sample Data**: Built-in sample CSV for testing
- **Responsive Design**: Works on desktop and mobile
## 🔧 Local Development
To run this locally:
```bash
pip install gradio
python app.py
```
## 📝 License
This project is for educational and personal use purposes.
---
**Made with ❤️ for better networking events!** |