readme.md

# Product Categorization App - One-Click Solution

This is a turnkey solution for categorizing products based on their similarity to ingredients using Voyage AI.

## Quick Start

1. Place your `ingredient_embeddings_voyageai.pkl` file in the same folder as this README
2. Run the application:

   ```bash
   bash run_app.sh
   ```

3. That's it! A browser window will open with the app, and a public URL will be created for sharing

## What You Can Do

- **Text Input:** Enter product names one per line
- **File Upload:** Upload a JSON file with product data
- Adjust the number of categories and confidence threshold
- View the categorization results with confidence scores

## Hosting on Hugging Face Spaces

For permanent, free hosting on Gradio:

1. Create a free account on [Hugging Face](https://huggingface.co/)
2. Go to [Hugging Face Spaces](https://huggingface.co/spaces)
3. Click "Create a Space"
4. Select "Gradio" as the SDK
5. Upload all files (including your embeddings file) to the space
6. Your app will be automatically deployed!

## Files Included

- `app.py`: The main application code
- `requirements.txt`: Required Python packages
- `run_app.sh`: One-click deployment script

## Requirements

- Python 3.7+
- Internet connection (for Voyage AI API)