Updated cursor version

README.md

@@ -1,15 +1,104 @@
----
-title: Gradio Chatbot
-emoji: 💬
-colorFrom: yellow
-colorTo: purple
-sdk: gradio
-sdk_version: 5.42.0
-app_file: app.py
-pinned: false
-hf_oauth: true
-hf_oauth_scopes:
- - inference-api
----
-
-An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).
+# Business Category Description Generator
+
+A Hugging Face Gradio application that generates CLIP-ready visual descriptions for business category keywords from CSV files.
+
+## Features
+
+- 📤 **Upload Multiple CSV Files**: Process one or more CSV files at once
+- 🔄 **Batch Processing**: Automatically processes all unique categories from your files
+- 🤖 **AI-Powered**: Uses Meta's Llama 3.3 70B model for high-quality descriptions
+- 📊 **Progress Tracking**: Real-time progress updates during processing
+- 💾 **Automatic Saving**: Output files are automatically generated with timestamps
+- 📥 **Easy Download**: Download all processed files directly from the interface
+
+## How to Use
+
+### 1. Deploy to Hugging Face Spaces
+
+1. Go to [Hugging Face Spaces](https://huggingface.co/spaces)
+2. Click "Create new Space"
+3. Choose "Gradio" as the SDK
+4. Upload `app.py` and `requirements.txt`
+5. Your app will be deployed automatically!
+
+### 2. Prepare Your CSV Files
+
+Your CSV files should contain a column with business category keywords. For example:
+
+```csv
+category,other_column
+Car Rental For Self Driven,additional_data
+Mehandi,additional_data
+Photographer,additional_data
+Equipment,additional_data
+```
+
+### 3. Use the Application
+
+1. **Login**: Click the login button and authenticate with your Hugging Face account
+2. **Upload Files**: Upload one or more CSV files
+3. **Specify Column**: Enter the name of the column containing categories (default: "category")
+4. **Adjust Settings** (optional):
+   - Max Tokens: 64-512 (default: 256)
+   - Temperature: 0.1-1.0 (default: 0.7)
+   - Top-p: 0.1-1.0 (default: 0.9)
+5. **Process**: Click "Process Files" and wait for completion
+6. **Download**: Download the output CSV files with descriptions
+
+## Output Format
+
+Each output CSV file contains:
+
+| Column | Description |
+|--------|-------------|
+| `Category` | The original category keyword |
+| `Description` | The generated CLIP-ready visual description |
+| `Raw_Response` | The complete model response (JSON format) |
+
+## Example Output
+
+```csv
+Category,Description,Raw_Response
+Car Rental For Self Driven,"a car available for self-drive rental, parked at a pickup spot without a chauffeur; looks travel-ready, clean, well-maintained, keys handed over to customer","{""Category"": ""Car Rental For Self Driven"", ""Description"": ""...""}"
+```
+
+## Model Settings
+
+- **Max Tokens**: Controls the maximum length of generated descriptions
+- **Temperature**: Higher values (0.8-1.0) make output more creative, lower values (0.3-0.5) make it more focused
+- **Top-p**: Nucleus sampling parameter, controls diversity
+
+## Technical Details
+
+- **Model**: meta-llama/Llama-3.3-70B-Instruct
+- **Framework**: Gradio 4.0+
+- **Processing**: Categories are deduplicated automatically
+- **Output Files**: Named as `output_{original_name}_{timestamp}.csv`
+
+## Troubleshooting
+
+### "Column not found" error
+- Check that the column name matches exactly (case-sensitive)
+- View the error message to see available columns
+
+### "Please login" error
+- Make sure you're logged in with a valid Hugging Face account
+- Check that your account has access to the Inference API
+
+### Slow processing
+- The model processes each unique category individually
+- Large files with many unique categories will take longer
+- Consider splitting very large files into smaller batches
+
+## Local Development
+
+To run locally:
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+## License
+
+This project uses the Llama 3.3 model which requires agreement to Meta's license terms.