README.md

metadata

title: Party Planner - Guest Table Arranger
emoji: 🎉
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.34.2
app_file: app.py
pinned: false

🎉 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

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:

pip install gradio
python app.py

📝 License

This project is for educational and personal use purposes.

---

Made with ❤️ for better networking events!