README_HF.md

# 🎉 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!**