| # TRIQA Hugging Face Demo - Quick Start Guide |
|
|
| ## 🚀 Create Your Hugging Face Space |
|
|
| ### Step 1: Create the Space |
| 1. Go to https://huggingface.co/spaces |
| 2. Click "Create new Space" |
| 3. Fill in: |
| - **Space name**: `triqa-image-quality-assessment` |
| - **License**: MIT |
| - **SDK**: Gradio |
| - **Hardware**: CPU (or GPU if available) |
| - **Visibility**: Public |
|
|
| ### Step 2: Upload Files |
| Upload these files from this folder to your Hugging Face Space: |
|
|
| #### Core Files (Upload these first): |
| - `app.py` - Main application |
| - `README.md` - Space description |
| - `requirements.txt` - Dependencies |
| - `package.json` - Node.js config |
| - `convnext_original.py` - Model architecture |
| - `convnext_finetune.py` - Model architecture |
| - `sample_image/` folder - Sample images |
|
|
| #### Model Files (Download from Box first): |
| 1. Go to: https://utexas.box.com/s/8aw6axc2lofouja65uc726lca8b1cduf |
| 2. Download the model files |
| 3. Create these directories in your Space: |
| - `feature_models/` |
| - `Regression_Models/` |
| 4. Upload the model files to their respective directories |
|
|
| ### Step 3: Test the Demo |
| 1. Wait for the build to complete (2-5 minutes) |
| 2. Upload a sample image |
| 3. Click "Assess Quality" |
| 4. Verify you get a quality score (1-5 scale) |
|
|
| ## 📁 File Structure in Your Space |
| ``` |
| your-space/ |
| ├── app.py |
| ├── README.md |
| ├── requirements.txt |
| ├── package.json |
| ├── convnext_original.py |
| ├── convnext_finetune.py |
| ├── sample_image/ |
| │ ├── 233045618.jpg |
| │ ├── 25239707.jpg |
| │ ├── 44009500.jpg |
| │ ├── 5129172.jpg |
| │ └── 85119046.jpg |
| ├── feature_models/ |
| │ ├── convnext_tiny_22k_224.pth |
| │ └── triqa_quality_aware.pth |
| └── Regression_Models/ |
| ├── KonIQ_scaler.save |
| └── KonIQ_TRIQA.save |
| ``` |
|
|
| ## 🎯 Expected Demo Features |
| - **Image Upload**: Drag & drop or click to upload |
| - **Quality Assessment**: Click button to get score |
| - **Sample Images**: Pre-loaded examples |
| - **Paper Links**: arXiv and IEEE links |
| - **Citation**: BibTeX citation |
|
|
| ## 🔧 Troubleshooting |
| - **Build fails**: Check requirements.txt |
| - **Models not loading**: Verify model files are uploaded |
| - **File not found**: Check file paths and names |
| - **Memory issues**: Use CPU hardware |
|
|
| ## 📞 Support |
| - GitHub: https://github.com/rajeshsureddi/triqa |
| - Paper: https://arxiv.org/pdf/2507.12687 |
|
|
| Your demo will be live at: `https://huggingface.co/spaces/your-username/triqa-image-quality-assessment` |
|
|
