DEPLOY.md

# Hugging Face Space Configuration

This file contains instructions for deploying this application to Hugging Face Spaces.

## Deployment Steps

1. Create a new Space on Hugging Face:
   - Go to https://huggingface.co/spaces
   - Click "Create new Space"
   - Select "Gradio" as the SDK
   - Choose a name for your Space
   - Set visibility (public or private)
   - Click "Create Space"

2. Upload the files:
   - Use Git to clone the Space repository
   - Copy all files from this project into the repository
   - Commit and push the changes

3. Alternative deployment method:
   - Use the Hugging Face CLI tool
   - Install with: `pip install huggingface_hub`
   - Login with: `huggingface-cli login`
   - Deploy with: `huggingface-cli upload-folder <your-username>/<your-space-name> ./`

## Required Files

The following files are required for deployment:
- `app.py` - Main application file
- `requirements.txt` - Dependencies
- `README.md` - Documentation with Space metadata
- `models/` directory - AI model implementation
- `utils/` directory - Utility functions

## Environment Variables

No environment variables are required for basic functionality.

## Resource Requirements

This application requires:
- GPU acceleration for optimal performance
- At least 2GB of RAM
- Sufficient disk space for model weights

## Troubleshooting

If you encounter issues during deployment:
1. Check the Space logs for error messages
2. Verify that all dependencies are correctly listed in requirements.txt
3. Ensure the app.py file is properly configured
4. Check that the Space has sufficient resources allocated