Upload 2 files

README.md

@@ -1,66 +1,42 @@
-# Party Planner - Guest Table Arranger
+---
+title: Party Planner - Guest Table Arranger
+emoji: 🎉
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+sdk_version: 5.34.2
+app_file: app.py
+pinned: false
+---
 
-A web application that helps you organize your guest list into tables for networking events. The app accepts CSV file uploads with guest information and creates visual circular table arrangements showing where each person will be seated.
+# 🎉 Party Planner - Guest Table Arranger
 
-## Features
+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.
 
-- 📁 Easy CSV file upload with drag & drop support
-- 📋 Parse guest information from name and message columns
-- ✅ Interactive guest selection with checkboxes
-- 🎯 Smart table arrangement algorithm
-- 🎨 Visual circular table layouts with seating positions
-- 📱 Responsive design for mobile and desktop
-- 🎨 Modern, intuitive UI
+## ✨ Features
 
-## Prerequisites
+- 📁 **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
 
-- Python 3.7 or higher
-- Web browser
+## 🚀 How to Use
 
-## Installation
+1. **Prepare Your CSV**: Create a CSV file with exactly 2 columns:
+   - **First column**: Guest names
+   - **Second column**: Job titles, roles, or descriptions
 
-1. **Clone or download this repository**
-   ```bash
-   git clone <repository-url>
-   cd LinkedInParty
-   ```
+2. **Upload Your Data**: 
+   - Paste your CSV content directly into the text box, OR
+   - Upload your CSV file using the file upload button
 
-2. **Install Python dependencies**
-   ```bash
-   pip install -r requirements.txt
-   ```
+3. **Arrange Tables**: Click the "🎯 Arrange Tables" button to see the smart arrangement
 
-## Usage
+4. **View Results**: See your guests organized into optimal table seating with industry-balanced distribution
 
-1. **Start the application**
-   ```bash
-   python3 app.py
-   ```
-
-2. **Open your browser**
-   Navigate to `http://localhost:5000`
-
-3. **Prepare your CSV file**
-   Your CSV should have exactly 2 columns:
-   - **First column**: guest names
-   - **Second column**: descriptions, roles, or messages
-
-4. **Upload your guest list**
-   - Click "Upload Guest List" or drag and drop your CSV file
-   - The app will parse and display up to 100 guests
-
-5. **Select guests for your event**
-   - Click on guest cards to select/deselect them
-   - You can select up to 30 guests (3 tables × 10 people)
-   - The stats panel shows your selection progress
-
-6. **Arrange tables**
-   - Click "Arrange Tables" to automatically organize your selected guests
-   - The app will create three visual circular tables
-   - Each table shows seating positions with guest initials
-   - Hover over seats to see full names and descriptions
-
-## CSV Format Example
+## 📄 CSV Format Example
 
 ```csv
 name,message
@@ -71,112 +47,81 @@ Emily Davis,Data Scientist at AI Labs
 David Wilson,Product Manager at Innovation Inc
 ```
 
-## Visual Table Layout
-
-The app creates beautiful circular table visualizations:
-- 🟢 **Green circles** represent individual seats
-- 🔵 **Blue center** shows the table number
-- 👤 **Initials** displayed on each seat
-- 💬 **Hover tooltips** show full names and descriptions
-- 🎯 **Smart positioning** arranges seats evenly around the table
-
-## How it Works
-
-### CSV Processing
-- Supports multiple CSV delimiters (comma, semicolon, tab)
-- Automatically detects column headers
-- Reads first column for names and second column for descriptions
-- Handles various encoding formats
-
-### Table Arrangement Algorithm
-The app uses a smart distribution algorithm:
-1. Categorizes guests by industry/role type based on message content
-2. Distributes major categories evenly across 3 tables
-3. Ensures each table has a maximum of 10 people
-4. Balances the number of people per table
-
-### Smart Categorization
-Based on message content, guests are categorized as:
-- **Tech**: engineer, developer, programmer, software, tech, it, data, ai, ml, technology, scientist
-- **Business**: manager, director, ceo, founder, executive, business, strategy, operations, consultant, product
-- **Creative**: designer, creative, marketing, content, writer, artist, media, communications, strategist
-- **Sales**: sales, account, client, business development, partnership, account manager
-- **Finance**: finance, accounting, investment, banking, financial, analyst, cfo
+## 🧠 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
 
-### Visual Seating Layout
-- **Circular tables** with realistic seating arrangements
-- **Even distribution** of seats around each table
-- **Interactive elements** with hover effects
-- **Responsive design** that works on all devices
+## 🎯 Table Arrangement Algorithm
 
-## Troubleshooting
+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
 
-### Common Issues
+## 📊 Sample Output
 
-1. **CSV Format Problems**
-   - Ensure your CSV has exactly 2 columns (name and message)
-   - Check that the first column contains guest names
-   - Verify the second column contains role descriptions
+```
+🎉 Successfully processed 25 guests!
 
-2. **File Upload Issues**
-   - Make sure you're uploading a .csv file
-   - Check that the file isn't corrupted or empty
-   - Try a smaller file first to test the format
+📊 Created 3 table(s) with smart distribution:
 
-3. **Parsing Errors**
-   - The app will try different delimiters automatically
-   - If parsing fails, check your CSV format in a text editor
-   - Ensure there are no special characters causing issues
+🍽️ **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
+  ...
 
-### Performance Tips
+🍽️ **Table 2** (8 guests):
+  1. **Emily Davis** - Data Scientist at AI Labs
+  2. **David Wilson** - Product Manager at Innovation Inc
+  ...
 
-- The app can handle up to 100 guests efficiently
-- Larger files may take a moment to process
-- Keep your CSV file under 1MB for best performance
+🍽️ **Table 3** (8 guests):
+  1. **Lisa Chen** - UX Designer at Design Studio
+  ...
 
-## Technical Details
+📈 **Table Statistics:**
+  Table 1: 9 guests
+  Table 2: 8 guests
+  Table 3: 8 guests
+```
 
-### Backend (Flask)
-- `app.py`: Main Flask application with CSV processing
-- Uses Python's built-in CSV module for parsing
-- RESTful API endpoints for frontend communication
+## 🛠️ Technical Details
 
-### Frontend (HTML/CSS/JavaScript)
-- Modern responsive design
-- Drag & drop file upload
-- Interactive guest selection
-- Circular table visualization with CSS positioning
-- Real-time statistics updates
+- **Framework**: Gradio (Python)
+- **Algorithm**: Smart categorization and distribution
+- **Deployment**: Hugging Face Spaces
+- **Dependencies**: gradio>=4.0.0
 
-### Dependencies
-- `flask`: Web framework
-- `flask-cors`: Cross-origin resource sharing
-- `werkzeug`: File upload handling
+## 🎨 Features
 
-## Limitations
+- **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
 
-- Maximum 30 guests can be arranged (3 tables × 10 people)
-- Maximum 100 guests can be loaded from CSV
-- CSV files only (no Excel or other formats)
-- Guest data is not persistent between sessions
+## 🔧 Local Development
 
-## Future Enhancements
+To run this locally:
 
-- [ ] Support for Excel files (.xlsx, .xls)
-- [ ] Save/load table arrangements
-- [ ] Export to CSV/PDF
-- [ ] Custom table sizes
-- [ ] Guest filtering by industry/company
-- [ ] Integration with calendar systems
-- [ ] Email invitations to guests
-- [ ] 3D table visualization
-- [ ] Drag & drop seating arrangements
+```bash
+pip install gradio
+python app.py
+```
 
-## Contributing
+## 📝 License
 
-Feel free to submit issues and enhancement requests!
+This project is for educational and personal use purposes.
 
-## License
+---
 
-This project is for educational and personal use purposes. 
+**Made with ❤️ for better networking events!** 

requirements.txt

@@ -1,4 +1,5 @@
 flask==3.0.0
 flask-cors==4.0.0
 werkzeug==3.1.3
-gunicorn==21.2.0 
+gunicorn==21.2.0
+gradio>=4.0.0