| # Upload Instructions for Hugging Face Space |
|
|
| ## Files to Upload |
|
|
| Upload these files to your Hugging Face Space (in this order): |
|
|
| ### 1. Core Application Files |
| - `app.py` - Main Gradio application |
| - `README.md` - Space description |
| - `requirements.txt` - Python dependencies |
| - `package.json` - Node.js configuration |
|
|
| ### 2. Model Architecture Files |
| - `convnext_original.py` - Original ConvNeXt model |
| - `convnext_finetune.py` - Fine-tuned ConvNeXt model |
|
|
| ### 3. Sample Images |
| - Upload the entire `sample_image/` folder with all images |
|
|
| ### 4. Model Weights (Download from Box first) |
| **IMPORTANT**: Download these files from Box first: https://utexas.box.com/s/8aw6axc2lofouja65uc726lca8b1cduf |
|
|
| Then create these directories and upload: |
| - `feature_models/convnext_tiny_22k_224.pth` (170MB) |
| - `feature_models/triqa_quality_aware.pth` (107MB) |
| - `Regression_Models/KonIQ_scaler.save` |
| - `Regression_Models/KonIQ_TRIQA.save` (111MB) |
|
|
| ## Upload Steps |
|
|
| 1. **Create the Space** on Hugging Face |
| 2. **Upload files** using the web interface or Git |
| 3. **Wait for build** (2-5 minutes) |
| 4. **Test the demo** with sample images |
|
|
| ## Expected Result |
|
|
| The demo will show: |
| - Image upload interface |
| - Quality assessment button |
| - Sample images for testing |
| - Quality score output (1-5 scale) |
| - Paper links and citation |
|
|
| ## Troubleshooting |
|
|
| If the demo doesn't work: |
| 1. Check that all model files are uploaded |
| 2. Verify file paths are correct |
| 3. Check the Space logs for errors |
| 4. Ensure all dependencies are in requirements.txt |
|
|
