fix

frontend/src/components/upload/GeneratedTextSection.tsx

@@ -1,4 +1,4 @@
-import { Container, TextArea, Button, IconButton } from '@ifrc-go/ui';
+import { Container, TextArea, Button, IconButton, Spinner } from '@ifrc-go/ui';
 import { DeleteBinLineIcon } from '@ifrc-go/icons';
 import styles from '../../pages/UploadPage/UploadPage.module.css';
 

py_backend/app/routers/caption.py

@@ -43,6 +43,9 @@ if settings.HF_API_KEY:
         db = SessionLocal()
         try:
             models = crud.get_models(db)
+            registered_count = 0
+            failed_count = 0
+            
             for model in models:
                 if (model.provider == "huggingface" and 
                     model.model_id and 
@@ -56,9 +59,20 @@ if settings.HF_API_KEY:
                         )
                         vlm_manager.register_service(service)
                         print(f"✓ Registered HF model: {model.m_code} -> {model.model_id}")
+                        registered_count += 1
+                    except ValueError as e:
+                        print(f"✗ Failed to register {model.m_code}: Configuration error - {e}")
+                        failed_count += 1
                     except Exception as e:
                         print(f"✗ Failed to register {model.m_code}: {e}")
-            print(f"✓ Hugging Face services registered dynamically from database")
+                        failed_count += 1
+            
+            if registered_count > 0:
+                print(f"✓ Hugging Face services registered: {registered_count} models successfully")
+            if failed_count > 0:
+                print(f"⚠️ Hugging Face services: {failed_count} models failed to register")
+            if registered_count == 0 and failed_count == 0:
+                print("○ No Hugging Face models found in database")
         finally:
             db.close()
     except Exception as e:
@@ -66,7 +80,7 @@ if settings.HF_API_KEY:
         import traceback
         traceback.print_exc()
 else:
-    print("○ Hugging Face services not configured")
+    print("○ Hugging Face services not configured (HF_API_KEY not set)")
 
 print(f"✓ Available models: {', '.join(vlm_manager.get_available_models())}")
 print(f"✓ Total services: {len(vlm_manager.services)}")

py_backend/app/services/huggingface_service.py

@@ -286,6 +286,11 @@ class ProvidersGenericVLMService(HuggingFaceService):
       ProvidersGenericVLMService(HF_TOKEN, "Qwen/Qwen2.5-VL-32B-Instruct", "QWEN2_5_VL_32B")
     """
     def __init__(self, api_key: str, model_id: str, public_name: str | None = None):
+        if not api_key:
+            raise ValueError("HF_API_KEY is required for Hugging Face models")
+        if not model_id:
+            raise ValueError("model_id is required for Hugging Face models")
+            
         # Use the default HuggingFace providers URL
         providers_url = "https://api-inference.huggingface.co/providers/openai"
         super().__init__(api_key, model_id, providers_url)

py_backend/debug_hf_models.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+"""
+Debug script to diagnose Hugging Face model registration issues.
+Run this script to check API key validity and model availability.
+"""
+
+import os
+import sys
+import asyncio
+import aiohttp
+import json
+from typing import Dict, Any
+
+# Add the current directory to Python path
+sys.path.append(os.path.dirname(os.path.abspath(__file__)))
+
+from app.config import settings
+from app.database import SessionLocal
+from app import crud
+
+async def test_hf_api_key(api_key: str) -> Dict[str, Any]:
+    """Test if the Hugging Face API key is valid"""
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json",
+    }
+    
+    # Test with a simple model list request
+    test_url = "https://api-inference.huggingface.co/models"
+    
+    try:
+        async with aiohttp.ClientSession() as session:
+            async with session.get(test_url, headers=headers, timeout=30) as resp:
+                if resp.status == 200:
+                    return {"valid": True, "message": "API key is valid"}
+                elif resp.status == 401:
+                    return {"valid": False, "message": "API key is invalid or expired"}
+                else:
+                    return {"valid": False, "message": f"API test failed with status {resp.status}"}
+    except Exception as e:
+        return {"valid": False, "message": f"API test failed: {str(e)}"}
+
+async def test_model_availability(api_key: str, model_id: str) -> Dict[str, Any]:
+    """Test if a specific model is available"""
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json",
+    }
+    
+    # Test with a simple text generation request
+    test_url = f"https://api-inference.huggingface.co/models/{model_id}"
+    payload = {
+        "inputs": "Hello, how are you?",
+        "parameters": {"max_new_tokens": 10}
+    }
+    
+    try:
+        async with aiohttp.ClientSession() as session:
+            async with session.post(test_url, headers=headers, json=payload, timeout=30) as resp:
+                if resp.status == 200:
+                    return {"available": True, "message": "Model is available"}
+                elif resp.status == 404:
+                    return {"available": False, "message": "Model not found"}
+                elif resp.status == 503:
+                    return {"available": False, "message": "Model is loading or unavailable"}
+                else:
+                    return {"available": False, "message": f"Model test failed with status {resp.status}"}
+    except Exception as e:
+        return {"available": False, "message": f"Model test failed: {str(e)}"}
+
+async def main():
+    """Main diagnostic function"""
+    print("🔍 Hugging Face Model Diagnostic Tool")
+    print("=" * 50)
+    
+    # Check if API key is set
+    if not settings.HF_API_KEY:
+        print("❌ HF_API_KEY is not set in environment variables")
+        print("   Please set HF_API_KEY to your Hugging Face API token")
+        return
+    
+    print(f"✅ HF_API_KEY is set (length: {len(settings.HF_API_KEY)})")
+    
+    # Test API key validity
+    print("\n🔑 Testing API key validity...")
+    api_test = await test_hf_api_key(settings.HF_API_KEY)
+    if api_test["valid"]:
+        print(f"✅ {api_test['message']}")
+    else:
+        print(f"❌ {api_test['message']}")
+        print("   Please check your Hugging Face API token at https://huggingface.co/settings/tokens")
+        return
+    
+    # Get models from database
+    print("\n📋 Checking models in database...")
+    db = SessionLocal()
+    try:
+        models = crud.get_models(db)
+        hf_models = [m for m in models if m.provider == "huggingface" and m.model_id]
+        
+        if not hf_models:
+            print("⚠️ No Hugging Face models found in database")
+            return
+        
+        print(f"✅ Found {len(hf_models)} Hugging Face models in database:")
+        for model in hf_models:
+            print(f"   - {model.m_code}: {model.model_id}")
+        
+        # Test each model
+        print("\n🧪 Testing model availability...")
+        for model in hf_models:
+            print(f"\nTesting {model.m_code} ({model.model_id})...")
+            model_test = await test_model_availability(settings.HF_API_KEY, model.model_id)
+            
+            if model_test["available"]:
+                print(f"   ✅ {model_test['message']}")
+            else:
+                print(f"   ❌ {model_test['message']}")
+                
+    finally:
+        db.close()
+    
+    print("\n" + "=" * 50)
+    print("💡 Troubleshooting Tips:")
+    print("1. Check your Hugging Face API token at https://huggingface.co/settings/tokens")
+    print("2. Ensure your token has 'read' permissions")
+    print("3. Some models may require special access or may be temporarily unavailable")
+    print("4. Check model availability at https://huggingface.co/models")
+    print("5. Network issues can cause connection failures")
+
+if __name__ == "__main__":
+    asyncio.run(main())