Enhance OpenAI client configuration and error handling; add connection test at startup

app.py

@@ -23,7 +23,12 @@ openai_api_key = os.getenv("OPENAI_API_KEY")
 if not openai_api_key:
     raise ValueError("OPENAI_API_KEY not found. Please set it in your environment variables or .env file.")
 
-client = OpenAI(api_key=openai_api_key)
+# Configure OpenAI client with settings optimized for Hugging Face Spaces
+client = OpenAI(
+    api_key=openai_api_key,
+    timeout=60.0,  # Longer timeout for HF Spaces network
+    max_retries=3  # Retry on connection failures
+)
 
 # Explanation complexity levels with clear descriptions
 EXPLANATION_LEVELS = {
@@ -96,16 +101,32 @@ def explain_concept(question, level, language):
     except Exception as e:
         # Provide more specific error messages for common issues
         error_msg = str(e).lower()
-        if "connection" in error_msg or "timeout" in error_msg:
-            yield "❌ Connection error: Unable to reach OpenAI API. Please check your internet connection and try again."
-        elif "api key" in error_msg or "authentication" in error_msg:
-            yield "❌ Authentication error: Invalid API key. Please check your OpenAI API key configuration."
-        elif "rate limit" in error_msg:
-            yield "❌ Rate limit exceeded: Too many requests. Please wait a moment and try again."
-        elif "model" in error_msg:
-            yield "❌ Model error: The specified model is not available. Please try again later."
+        error_type = type(e).__name__
+        
+        # Log full error for debugging (visible in HF Spaces logs)
+        print(f"❌ API Error [{error_type}]: {str(e)}")
+        
+        if "connection" in error_msg or "timeout" in error_msg or "ssl" in error_msg:
+            yield f"""❌ **Connection Error**: Unable to reach OpenAI API.
+
+**On Hugging Face Spaces:**
+1. Verify `OPENAI_API_KEY` is set in **Settings → Repository secrets**
+2. Restart the Space after adding the secret
+3. Check the Logs tab for detailed error messages
+
+**Error details**: `{error_type}: {str(e)[:200]}`"""
+        elif "api key" in error_msg or "authentication" in error_msg or "401" in error_msg:
+            yield """❌ **Authentication Error**: Invalid or missing API key.
+
+**Fix**: Go to **Settings → Repository secrets** and add:
+- Name: `OPENAI_API_KEY`
+- Value: Your OpenAI API key (starts with `sk-`)"""
+        elif "rate limit" in error_msg or "429" in error_msg:
+            yield "❌ **Rate Limit**: Too many requests. Please wait a moment and try again."
+        elif "model" in error_msg or "404" in error_msg:
+            yield f"❌ **Model Error**: The model may not be available.\n\nError: `{str(e)}`"
         else:
-            yield f"❌ Error generating explanation: {str(e)}"
+            yield f"❌ **Error**: `[{error_type}]` {str(e)}"
 
 # Create enhanced Gradio interface with modern styling
 with gr.Blocks(
@@ -203,6 +224,22 @@ if __name__ == "__main__":
     
     print("🚀 Starting AI Concept Explainer...")
     print(f"Environment: {'Hugging Face Spaces' if is_space else 'Local Development'}")
+    print(f"API Key configured: {'✅ Yes' if openai_api_key else '❌ No'}")
+    if openai_api_key:
+        print(f"API Key starts with: {openai_api_key[:10]}...")
+    
+    # Test OpenAI connection at startup (HF Spaces only)
+    if is_space:
+        try:
+            print("\n🔍 Testing OpenAI API connection...")
+            # Simple API test
+            test_models = client.models.list()
+            print("✅ OpenAI API connection successful!")
+        except Exception as e:
+            print(f"⚠️  WARNING: OpenAI API connection test failed!")
+            print(f"   Error: [{type(e).__name__}] {str(e)}")
+            print(f"   The app will start, but API calls may fail.")
+            print(f"   Check: 1) OPENAI_API_KEY secret is set, 2) API key is valid")
     
     if is_space:
         # Production configuration for Hugging Face Spaces

requirements.txt

@@ -3,7 +3,9 @@
 # gradio==5.46.0
 # openai==1.107.3
 # python-dotenv==1.1.1
+# httpx==0.27.0
 
 gradio
 openai
-python-dotenv
+python-dotenv
+httpx