Update app.py

app.py

@@ -1,6 +1,6 @@
 # --------------------------------------------------------------
 # IGCSE/GCSE Language Platform – 100% free on Hugging Face Spaces
-# Model: openai/gpt-oss-20b:groq (via HF Inference API)
+# Model: deepseek-ai/DeepSeek-V3.2-Exp:novita (via HF Inference API)
 # --------------------------------------------------------------
 
 import os
@@ -18,7 +18,7 @@ if not HF_TOKEN:
 
 client = InferenceClient(api_key=os.environ["HF_TOKEN"])
 
-MODEL = "openai/gpt-oss-20b:groq"
+MODEL = "deepseek-ai/DeepSeek-V3.2-Exp:novita"
 
 # ---------- 2. Global storage ----------
 papers_storage = []
@@ -48,10 +48,15 @@ efl_topics = [
 # ---------- 4. Helper: call the model ----------
 def call_model(messages: list, system: str = "", max_tokens=1000):
     try:
+        # Prepare messages with system prompt if provided
+        formatted_messages = []
+        if system:
+            formatted_messages.append({"role": "system", "content": system})
+        formatted_messages.extend(messages)
+        
         resp = client.chat.completions.create(
             model=MODEL,
-            messages=[{"role": "system", "content": system}] + messages
-            if system else messages,
+            messages=formatted_messages,
             max_tokens=max_tokens,
             temperature=0.7,
         )
@@ -79,12 +84,15 @@ def ai_tutor_chat(message, history, subject, topic, level):
         return history
 
     system = f"""You are an expert {'French' if subject == 'French' else 'EFL'} {level} tutor.
-Focus on {topic or 'any topic'}. Be encouraging and clear. Adjust difficulty for {level} level."""
+Focus on {topic or 'any topic'}. Be encouraging, clear, and pedagogical. 
+Adjust difficulty and explanations appropriately for {level} level students.
+Provide detailed explanations with examples when needed."""
+    
     msgs = [{"role": "user" if i % 2 == 0 else "assistant", "content": turn}
             for pair in history for i, turn in enumerate(pair) if turn]
     msgs.append({"role": "user", "content": message})
 
-    bot = call_model(msgs, system)
+    bot = call_model(msgs, system, max_tokens=1500)
     history.append((message, bot))
     return history
 
@@ -97,20 +105,23 @@ def translate_text(text, direction):
         return "Enter text first."
     src = "English" if direction == "English → French" else "French"
     tgt = "French" if direction == "English → French" else "English"
-    prompt = f"Translate from {src} to {tgt}. Only the translation:\n\n{text}"
-    return call_model([{"role": "user", "content": prompt}], max_tokens=500)
+    system = f"You are a professional translator. Provide accurate, natural translations from {src} to {tgt}."
+    prompt = f"Translate this text to {tgt}. Provide only the translation without any explanations:\n\n{text}"
+    return call_model([{"role": "user", "content": prompt}], system, max_tokens=800)
 
 # ---------- 8. Dictionary ----------
 def dictionary_lookup(word):
     if not word.strip():
         return "Enter a French word."
-    prompt = f"""Give a clear French dictionary entry for "{word}":
+    system = "You are a French language dictionary expert. Provide comprehensive, accurate definitions."
+    prompt = f"""Provide a detailed French dictionary entry for "{word}":
 - Part of speech
 - English meaning(s)
 - Gender (if noun)
-- 2 example sentences (French + English)
-- Common phrases"""
-    return call_model([{"role": "user", "content": prompt}], max_tokens=800)
+- 3 example sentences (French with English translations)
+- Common phrases and idioms using this word
+- Any important usage notes"""
+    return call_model([{"role": "user", "content": prompt}], system, max_tokens=1200)
 
 # ---------- 9. Practice Questions (Enhanced with PDF context) ----------
 def generate_question(subject, topic, level):
@@ -122,50 +133,74 @@ def generate_question(subject, topic, level):
     for paper_id, content in pdf_content_storage.items():
         paper = next((p for p in papers_storage if p['id'] == paper_id), None)
         if paper and paper['subject'].lower() == subject.lower() and paper['level'] == level:
-            # Use first 2000 chars of PDF content
-            pdf_context += f"\n\nReference material from {paper['title']}:\n{content[:2000]}"
+            # Use first 3000 chars of PDF content for better context
+            pdf_context += f"\n\nReference material from {paper['title']}:\n{content[:3000]}"
     
-    prompt = f"""Create ONE {level} {subject} exam question on "{topic}".
-{"Use this reference material to ensure authenticity:" + pdf_context if pdf_context else ""}
-
-Return valid JSON with exactly these keys:
-{{"question": "...", "expectedAnswer": "short description of expected answer", "markScheme": "brief marking criteria"}}"""
+    system = f"You are an expert {level} {subject} examiner. Create authentic, challenging exam questions."
+    prompt = f"""Create ONE {level} {subject} exam question on the topic: "{topic}".
+{"Base the question style and difficulty on this reference material:" + pdf_context if pdf_context else ""}
+
+The question should:
+- Be appropriate for {level} level
+- Test understanding, not just memorization
+- Include clear instructions
+- Be answerable in 5-10 minutes
+
+Return ONLY valid JSON with exactly these keys (no markdown formatting):
+{{"question": "the complete question text", "expectedAnswer": "detailed description of what a good answer should include", "markScheme": "clear marking criteria with point allocations"}}"""
     
-    txt = call_model([{"role": "user", "content": prompt}], max_tokens=800)
+    txt = call_model([{"role": "user", "content": prompt}], system, max_tokens=1000)
     try:
-        data = json.loads(txt.replace("```json", "").replace("```", "").strip())
+        # Clean up potential markdown formatting
+        clean_txt = txt.replace("```json", "").replace("```", "").strip()
+        data = json.loads(clean_txt)
         return data["question"], data.get("expectedAnswer", ""), data.get("markScheme", "")
-    except Exception:
-        return txt, "", ""
+    except Exception as e:
+        return txt, "", f"Error parsing response: {e}"
 
 def check_answer(question, expected, user_answer, subject, level):
     if not user_answer.strip():
         return "Write your answer first!"
-    prompt = f"""You are a {level} {subject} examiner.
+    
+    system = f"You are a {level} {subject} examiner. Provide constructive, detailed feedback."
+    prompt = f"""Evaluate this student's answer:
+
 Question: {question}
-Expected: {expected}
-Student answer: {user_answer}
 
-Reply with JSON:
-{{"isCorrect": true/false, "score": 0-100, "feedback": "...", "improvements": "..."}}"""
-    txt = call_model([{"role": "user", "content": prompt}], max_tokens=600)
+Expected answer criteria: {expected}
+
+Student's answer:
+{user_answer}
+
+Provide a detailed evaluation in JSON format (no markdown):
+{{"isCorrect": true/false, "score": 0-100, "feedback": "detailed feedback on what was done well", "improvements": "specific suggestions for improvement", "strengths": "what the student did correctly"}}"""
+    
+    txt = call_model([{"role": "user", "content": prompt}], system, max_tokens=800)
     try:
-        fb = json.loads(txt.replace("```json", "").replace("```", "").strip())
-        return f"""Score: {fb['score']}%
-Feedback: {fb['feedback']}
-Improvements: {fb['improvements']}"""
+        clean_txt = txt.replace("```json", "").replace("```", "").strip()
+        fb = json.loads(clean_txt)
+        return f"""✅ Score: {fb['score']}%
+
+📝 Feedback:
+{fb['feedback']}
+
+💪 Strengths:
+{fb.get('strengths', 'Good effort!')}
+
+🎯 Areas for Improvement:
+{fb['improvements']}"""
     except Exception:
         return txt
 
 # ---------- 10. Admin – Past Papers ----------
 def verify_admin_password(password):
     if password == ADMIN_PASSWORD:
-        return gr.update(visible=True), gr.update(visible=False), "Access granted!"
-    return gr.update(visible=False), gr.update(visible=True), "Incorrect password!"
+        return gr.update(visible=True), gr.update(visible=False), "✅ Access granted!"
+    return gr.update(visible=False), gr.update(visible=True), "❌ Incorrect password!"
 
 def upload_paper(title, subject, level, content, pdf_file):
     if not all([title, subject, level, content]):
-        return "Fill all required fields!", get_papers_list()
+        return "❌ Fill all required fields!", get_papers_list()
     
     paper_id = len(papers_storage) + 1
     
@@ -175,7 +210,7 @@ def upload_paper(title, subject, level, content, pdf_file):
         pdf_text = extract_text_from_pdf(pdf_file)
         if pdf_text and not pdf_text.startswith("Error"):
             pdf_content_storage[paper_id] = pdf_text
-            content += f"\n\n[PDF content extracted: {len(pdf_text)} characters]"
+            content += f"\n\n[📄 PDF content extracted: {len(pdf_text)} characters]"
     
     papers_storage.append({
         "id": paper_id,
@@ -186,13 +221,13 @@ def upload_paper(title, subject, level, content, pdf_file):
         "has_pdf": bool(pdf_text and not pdf_text.startswith("Error")),
         "uploaded_at": datetime.now().strftime("%Y-%m-%d %H:%M")
     })
-    return "Uploaded successfully!", get_papers_list()
+    return "✅ Uploaded successfully!", get_papers_list()
 
 def get_papers_list():
     if not papers_storage:
         return "No papers yet."
     return "\n".join(
-        f"**{p['title']}** ({p['subject'].upper()} - {p['level']}) {'📄 PDF' if p.get('has_pdf') else ''}\n{p['uploaded_at']}\n{p['content'][:120]}...\n{'─'*40}"
+        f"**{p['title']}** ({p['subject'].upper()} - {p['level']}) {'📄 PDF' if p.get('has_pdf') else ''}\n📅 {p['uploaded_at']}\n{p['content'][:120]}...\n{'─'*60}"
         for p in papers_storage
     )
 
@@ -200,22 +235,26 @@ def view_papers_student(subject, level):
     filtered = [p for p in papers_storage 
                 if p["subject"] == subject.lower() and p["level"] == level]
     if not filtered:
-        return f"No {subject} {level} papers."
+        return f"No {subject} {level} papers available yet."
     return "\n".join(
-        f"**{p['title']}** {'📄 Has PDF reference' if p.get('has_pdf') else ''}\n{p['content']}\n{'═'*50}"
+        f"**{p['title']}** {'📄 Has PDF reference material' if p.get('has_pdf') else ''}\n{p['content']}\n{'═'*60}"
         for p in filtered
     )
 
 # ---------- 11. Gradio UI ----------
 with gr.Blocks(theme=gr.themes.Soft(), title="IGCSE/GCSE Platform") as app:
-    gr.Markdown("# IGCSE/GCSE Language Platform\n🎓 Free AI Tutor, Translator, Dictionary & Past Papers with PDF Support")
+    gr.Markdown("""
+    # 🎓 IGCSE/GCSE Language Platform
+    ### Powered by DeepSeek AI - Advanced Language Learning Assistant
+    Free AI Tutor, Translator, Dictionary & Past Papers with PDF Support
+    """)
 
     with gr.Tabs():
         # ───── STUDENT ─────
-        with gr.Tab("Student Portal"):
+        with gr.Tab("📚 Student Portal"):
             with gr.Tabs():
-                with gr.Tab("AI Tutor"):
-                    gr.Markdown("### Chat with your AI tutor")
+                with gr.Tab("🤖 AI Tutor"):
+                    gr.Markdown("### Chat with your AI tutor - Get personalized help!")
                     with gr.Row():
                         subj = gr.Radio(["French", "EFL"], label="Subject", value="French")
                         lvl = gr.Radio(["IGCSE", "GCSE"], label="Level", value="IGCSE")
@@ -225,57 +264,60 @@ with gr.Blocks(theme=gr.themes.Soft(), title="IGCSE/GCSE Platform") as app:
                         return gr.Dropdown(choices=french_topics if s == "French" else efl_topics, value=None)
                     subj.change(upd_topics, subj, topc)
 
-                    chat = gr.Chatbot(height=450)
-                    txt = gr.Textbox(placeholder="Ask anything…", label="Message", scale=4)
+                    chat = gr.Chatbot(height=450, show_label=False)
+                    txt = gr.Textbox(placeholder="Ask anything about your studies...", label="Message", scale=4)
                     with gr.Row():
-                        send = gr.Button("Send")
-                        clr = gr.Button("Clear")
+                        send = gr.Button("Send 📤", variant="primary")
+                        clr = gr.Button("Clear 🗑️")
                     send.click(ai_tutor_chat, [txt, chat, subj, topc, lvl], chat)
                     txt.submit(ai_tutor_chat, [txt, chat, subj, topc, lvl], chat)
                     clr.click(clear_chat, outputs=chat)
 
-                with gr.Tab("Translator"):
+                with gr.Tab("🔄 Translator"):
+                    gr.Markdown("### Accurate English ⟷ French Translation")
                     dir_ = gr.Radio(["English → French", "French → English"], label="Direction", value="English → French")
-                    inp = gr.Textbox(lines=4, label="Text")
-                    out = gr.Textbox(lines=4, label="Translation")
-                    gr.Button("Translate").click(translate_text, [inp, dir_], out)
-
-                with gr.Tab("Dictionary"):
-                    w = gr.Textbox(placeholder="French word", label="Word")
-                    o = gr.Textbox(lines=12, label="Definition")
-                    gr.Button("Lookup").click(dictionary_lookup, w, o)
-
-                with gr.Tab("Practice"):
-                    gr.Markdown("### Generate exam-style questions (powered by uploaded past papers)")
+                    inp = gr.Textbox(lines=5, label="Input Text", placeholder="Enter text to translate...")
+                    out = gr.Textbox(lines=5, label="Translation")
+                    gr.Button("Translate 🔄", variant="primary").click(translate_text, [inp, dir_], out)
+
+                with gr.Tab("📖 Dictionary"):
+                    gr.Markdown("### French Dictionary Lookup")
+                    w = gr.Textbox(placeholder="Enter a French word...", label="Word")
+                    o = gr.Textbox(lines=15, label="Definition & Examples")
+                    gr.Button("Lookup 🔍", variant="primary").click(dictionary_lookup, w, o)
+
+                with gr.Tab("✍️ Practice"):
+                    gr.Markdown("### Generate Exam-Style Questions\n*Questions are generated based on uploaded past papers for authenticity*")
                     with gr.Row():
                         ps = gr.Radio(["French", "EFL"], label="Subject", value="French")
                         pl = gr.Radio(["IGCSE", "GCSE"], label="Level", value="IGCSE")
                         pt = gr.Dropdown(french_topics, label="Topic")
                     ps.change(upd_topics, ps, pt)
 
-                    q = gr.Textbox(label="Question", lines=3)
-                    exp = gr.Textbox(label="Expected Answer", lines=2, visible=False)
-                    mark = gr.Textbox(label="Mark Scheme", lines=2)
-                    ans = gr.Textbox(lines=5, label="Your answer")
-                    fb = gr.Textbox(lines=8, label="Feedback")
+                    q = gr.Textbox(label="📝 Question", lines=4)
+                    exp = gr.Textbox(label="Expected Answer (Hidden)", lines=2, visible=False)
+                    mark = gr.Textbox(label="📊 Mark Scheme", lines=3)
+                    ans = gr.Textbox(lines=6, label="✍️ Your Answer", placeholder="Type your answer here...")
+                    fb = gr.Textbox(lines=10, label="📋 Detailed Feedback")
 
-                    gr.Button("Generate Question").click(generate_question, [ps, pt, pl], [q, exp, mark])
-                    gr.Button("Check Answer").click(check_answer, [q, exp, ans, ps, pl], fb)
+                    with gr.Row():
+                        gr.Button("Generate Question 🎲", variant="primary").click(generate_question, [ps, pt, pl], [q, exp, mark])
+                        gr.Button("Check Answer ✅", variant="secondary").click(check_answer, [q, exp, ans, ps, pl], fb)
 
-                with gr.Tab("Past Papers"):
-                    gr.Markdown("### View past papers and reference materials")
+                with gr.Tab("📄 Past Papers"):
+                    gr.Markdown("### View Past Papers & Reference Materials")
                     with gr.Row():
                         psb = gr.Radio(["French", "EFL"], label="Subject", value="French")
                         plb = gr.Radio(["IGCSE", "GCSE"], label="Level", value="IGCSE")
-                    pd = gr.Textbox(lines=20, label="Papers")
-                    gr.Button("Show Papers").click(view_papers_student, [psb, plb], pd)
+                    pd = gr.Textbox(lines=20, label="Available Papers", show_label=False)
+                    gr.Button("Show Papers 📚", variant="primary").click(view_papers_student, [psb, plb], pd)
 
         # ───── ADMIN ─────
-        with gr.Tab("Admin Panel"):
+        with gr.Tab("🔐 Admin Panel"):
             with gr.Column() as login_section:
-                gr.Markdown("### 🔒 Admin Login")
+                gr.Markdown("### 🔒 Admin Login Required")
                 pwd = gr.Textbox(label="Password", type="password", placeholder="Enter admin password")
-                login_btn = gr.Button("Login", variant="primary")
+                login_btn = gr.Button("Login 🔓", variant="primary")
                 login_status = gr.Textbox(label="Status", interactive=False)
             
             with gr.Column(visible=False) as admin_section:
@@ -286,13 +328,13 @@ with gr.Blocks(theme=gr.themes.Soft(), title="IGCSE/GCSE Platform") as app:
                         with gr.Row():
                             s = gr.Radio(["French", "EFL"], label="Subject", value="French")
                             lv = gr.Radio(["IGCSE", "GCSE"], label="Level", value="IGCSE")
-                        c = gr.Textbox(lines=4, label="Description/Notes")
-                        pdf = gr.File(label="Upload PDF (optional)", file_types=[".pdf"])
-                        gr.Markdown("*PDF will be analyzed to generate authentic exam questions*")
-                        up = gr.Button("Upload", variant="primary")
+                        c = gr.Textbox(lines=5, label="Description/Notes")
+                        pdf = gr.File(label="📎 Upload PDF (optional)", file_types=[".pdf"])
+                        gr.Markdown("*📄 PDF content will be extracted and used to generate authentic exam-style questions*")
+                        up = gr.Button("Upload 📤", variant="primary")
                         st = gr.Textbox(label="Status")
                     with gr.Column():
-                        lst = gr.Textbox(lines=20, label="All papers", value=get_papers_list())
+                        lst = gr.Textbox(lines=22, label="📚 All Uploaded Papers", value=get_papers_list())
                 up.click(upload_paper, [t, s, lv, c, pdf], [st, lst])
             
             login_btn.click(
@@ -303,17 +345,23 @@ with gr.Blocks(theme=gr.themes.Soft(), title="IGCSE/GCSE Platform") as app:
 
     gr.Markdown("""
     ---
-    **How to run:**
-    1. Fork this Space
-    2. Settings → Secrets → Add `HF_TOKEN` (your Hugging Face token)
-    3. Install dependencies: `gradio`, `huggingface_hub`, `PyPDF2`
-    4. Restart → Done!
+    ### 🚀 How to Deploy on Hugging Face Spaces:
+    1. **Fork/Create** this Space
+    2. **Settings** → **Secrets** → Add `HF_TOKEN` (your Hugging Face token)
+    3. Upload `requirements.txt` with: `gradio`, `huggingface_hub`, `PyPDF2`
+    4. **Restart** the Space → You're live! 🎉
+    
+    ### ✨ Key Features:
+    - ✅ **IGCSE & GCSE** support for both levels
+    - ✅ **PDF Upload** for authentic past papers
+    - ✅ **AI-Powered** question generation using DeepSeek V3.2
+    - ✅ **Intelligent Feedback** on practice answers
+    - ✅ **Password Protection** for admin panel
+    - ✅ **Translator & Dictionary** tools included
+    
+    **Admin Password:** `@mikaelJ46`
     
-    **Features:**
-    - ✅ IGCSE & GCSE support
-    - ✅ PDF upload for past papers
-    - ✅ AI generates questions based on uploaded PDFs
-    - ✅ Password-protected admin panel (@mikaelJ46)
+    *Powered by DeepSeek V3.2 Exp via Hugging Face Inference API*
     """)
 
 app.launch()