Update README.md

README.md

@@ -29,8 +29,13 @@ A Hugging Face Gradio application that generates CLIP-ready visual descriptions
 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!
+4. Upload `app.py`, `requirements.txt`, and `README.md`
+5. **Enable OAuth (Required)**:
+   - Go to your Space's Settings
+   - Scroll to "OAuth" section
+   - Enable "OAuth" toggle
+   - This allows the app to use your HF Pro account's API access
+6. Your app will be deployed automatically!
 
 ### 2. Prepare Your CSV Files
 
@@ -46,15 +51,16 @@ 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):
+1. **Upload Files**: Upload one or more CSV files
+2. **Specify Column**: Enter the name of the column containing categories (default: "category")
+3. **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
+4. **Process**: Click "Process Files" and wait for completion
+5. **Download**: Download the output CSV files with descriptions
+
+*Note: Authentication is handled automatically through HF Spaces OAuth when enabled in settings.*
 
 ## Output Format
 
@@ -88,13 +94,19 @@ Car Rental For Self Driven,"a car available for self-drive rental, parked at a p
 
 ## Troubleshooting
 
+### "Hugging Face token not found" error
+- Make sure OAuth is enabled in your Space settings
+- Go to Space Settings → OAuth → Enable OAuth toggle
+- Restart your Space after enabling OAuth
+
 ### "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
+### Authentication errors
+- Ensure you have a Hugging Face Pro account for API access
+- Check that OAuth is properly configured in Space settings
+- Verify that your account has access to the Llama 3.3 model
 
 ### Slow processing
 - The model processes each unique category individually
@@ -106,10 +118,22 @@ Car Rental For Self Driven,"a car available for self-drive rental, parked at a p
 To run locally:
 
 ```bash
+# Install dependencies
 pip install -r requirements.txt
+
+# Set your Hugging Face token as an environment variable
+# Windows (PowerShell):
+$env:HF_TOKEN="your_hf_token_here"
+
+# Linux/Mac:
+export HF_TOKEN="your_hf_token_here"
+
+# Run the app
 python app.py
 ```
 
+Get your token from: https://huggingface.co/settings/tokens
+
 ## License
 
 This project uses the Llama 3.3 model which requires agreement to Meta's license terms.