Update app.py

app.py

@@ -1,38 +1,29 @@
 # ==============================================================================
 # اسم المشروع: وكيل الأزهريين الذكي (Deputy of Al-Azhar)
-# المحرك المدعوم: Google AI Studio (مستقل ومخصص لخدمة الطلاب)
-# النموذج المستخدم: Gemini 1.5 Flash (صاحب الذاكرة المليونية والـ 1500 طلب مجاني)
+# المحرك المدعوم: Hugging Face Serverless Inference API (سحابي ومجاني بالكامل)
+# النموذج المستخدم: Qwen 2.5 72B Instruct (التنين الصيني الخارق في الفقه واللغة العربية)
 # تـاريخ التحديث الأخير: يونيو 2026
 # ==============================================================================
 
+import os
 import streamlit as st
-import google.generativeai as genai
+from huggingface_hub import InferenceClient
 from pypdf import PdfReader
 from gtts import gTTS
 import io
 
 # ------------------------------------------------------------------------------
-# 1. نظام الحماية وجلب مفتاح جوجل المشفر (Security & Secrets)
+# 1. تهيئة المحرك السحابي الذكي (Serverless Inference API)
 # ------------------------------------------------------------------------------
-
+# نستخدم أضخم وأقوى نسخة من نموذج Qwen الخارق ليعمل سحابياً بدون استهلاك الرام المحلية
 try:
-    # جلب مفتاح Gemini بأمان من الـ Secrets (سواء محلياً أو على Streamlit Cloud)
-    GEMINI_API_KEY = st.secrets["GEMINI_API_KEY"]
-except Exception:
-    st.error("""
-    🔒 **خطأ في منظومة الأمان:** لم يتم العثور على مفتاح جيميناي الآمن.
-    - **إذا كنت تعمل محلياً:** تأكد من إنشاء مجلد اسمه `.streamlit` وبداخله ملف `secrets.toml` يحتوي على المفتاح باسم `GEMINI_API_KEY`.
-    - **إذا كنت ترفع التطبيق أونلاين:** تأكد من إضافة المفتاح في خيار `Advanced settings -> Secrets` على منصة الاستضافة.
-    """)
-    st.stop()
-
-# تهيئة وإعداد مكتبة جوجل باستخدام مفتاحك الخاص
-genai.configure(api_key=GEMINI_API_KEY)
+    client = InferenceClient(model="Qwen/Qwen2.5-72B-Instruct")
+except Exception as e:
+    st.error(f"⚠️ فشل الاتصال الأولي بالمحرك السحابي: {str(e)}")
 
 # ------------------------------------------------------------------------------
 # 2. إعدادات الواجهة الرسومية والهوية البصرية للتطبيق (UI Configuration)
 # ------------------------------------------------------------------------------
-
 st.set_page_config(
     page_title="وكيل الأزهريين الذكي",
     page_icon="🕌",
@@ -43,7 +34,6 @@ st.set_page_config(
 # ------------------------------------------------------------------------------
 # 3. صياغة التوجيهات النظامية الصارمة (System Prompt Engineering)
 # ------------------------------------------------------------------------------
-
 SYSTEM_PROMPT = """
 أنت الآن الـ AI الملقب بـ "وكيل الأزهريين" (Deputy of Al-Azhar)، خبير تعليمي ومدرس تراثي وعلمي متمكن متخصص في مناهج ومواد الأزهر الشريف بالكامل.
 - مهمتك الأساسية والمقدسة: مساعدة الطلاب والمعلمين بناءً على النصوص المرفوعة من كتب المعهد المرفقة.
@@ -54,136 +44,108 @@ SYSTEM_PROMPT = """
 """
 
 # ------------------------------------------------------------------------------
-# 4. الدوال البرمجية الخلفية للمشروع باستخدام جيميناي (Gemini Backend Functions)
+# 4. الدوال البرمجية الخلفية للمشروع السحابي (Cloud Backend Functions)
 # ------------------------------------------------------------------------------
-
-def get_gemini_answer(user_query, text_context, user_mode):
+def get_cloud_answer(user_query, text_context, user_mode):
     """
-    هذه الدالة مسؤولة عن إرسال الطلب، النصوص المستخرجة من الكتاب، وسؤال الطالب 
-    إلى سيرفرات Google لتتم معالجتها عبر نموذج Gemini 1.5 Flash الخارق.
+    هذه الدالة مسؤولة عن صياغة وإرسال الطلب سحابياً وتوليد الإجابات عبر خوادم Hugging Face.
     """
+    full_user_message = (
+        f"[بوابة الاستخدام الحالية في المنصة: {user_mode}]\n\n"
+        f"نص كتاب المعهد الأزهرى المرفوع كـ سياق معتمد:\n{text_context}\n\n"
+        f"طلب المستخدم وسؤاله الحالي الذي يحتاج إجابة:\n{user_query}"
+    )
+    
+    messages = [
+        {"role": "system", "content": SYSTEM_PROMPT},
+        {"role": "user", "content": full_user_message}
+    ]
+    
     try:
-        # إعداد الموديل مع تمرير التوجيهات النظامية الصارمة كـ System Instruction كما تدعمها جوجل
-        model = genai.GenerativeModel(
-            model_name='gemini-1.5-flash',
-            system_instruction=SYSTEM_PROMPT
-        )
-        
-        # صياغة الرسالة الشاملة التي تدمج السياق والوضع الحالي والسؤال لتوجيه الموديل بدقة
-        full_user_message = (
-            f"[بوابة الاستخدام الحالية في المنصة: {user_mode}]\n\n"
-            f"نص كتاب المعهد الأزهرى المرفوع كـ سياق معتمد:\n{text_context}\n\n"
-            f"طلب المستخدم وسؤاله الحالي الذي يحتاج إجابة:\n{user_query}"
-        )
-        
-        # ضبط الحرارة لمنع التأليف وضمان الدقة
-        config = genai.types.GenerationConfig(
+        completion = client.chat_completion(
+            messages=messages,
+            max_tokens=1500,
             temperature=0.4
         )
-        
-        # توليد المحتوى من السيرفر مباشرة
-        response = model.generate_content(full_user_message, generation_config=config)
-        return response.text
+        return completion.choices[0].message.content
     except Exception as e:
-        return f"⚠️ حدث خطأ أثناء الاتصال بسيرفر جيميناي: {str(e)}"
-
+        return f"⚠️ حدث خطأ أثناء الاتصال بالسيرفر السحابي لـ Qwen: {str(e)}"
 
 def extract_text_from_pdf(pdf_file):
-    """
-    مهمة هذه الدالة هي استقبال ملف الـ PDF الحقيقي المرفوع من الطالب أو المعلم،
-    والدخول إلى أعماقه لاستخراج كافة النصوص والحروف وإعادتها كـ سياق نصي متصل.
-    """
+    """استخراج النصوص من ملف الـ PDF المرفوع"""
     reader = PdfReader(pdf_file)
     extracted_text = ""
-    
-    # المرور على كافة صفحات ملف المعهد صفحة تلو الأخرى
     for page in reader.pages:
         text = page.extract_text()
         if text:
             extracted_text += text + "\n"
-            
     return extracted_text
 
-
 def text_to_speech_player(text_to_speak):
-    """
-    الميزة الأسطورية: استقبال رد الوكيل المكتوب، وتحويله في الذاكرة المؤقتة إلى ملف
-    صوتي MP3 ناطق بالفصحى وعرض مشغل صوتي تفاعلي يمنع ملل الطلاب أثناء المذاكرة.
-    """
+    """تحويل النص المكتوب إلى ملف صوتي مسموع في الرام فوراً"""
     try:
-        # توليد الصوت باللغة العربية الفصحى المبسطة وبسرعة عادية واضحة
-        tts = gTTS(text=text_to_speak, lang='ar', slow=False)
-        
-        # إنشاء وعاء في ذاكرة الرام العشوائية (RAM) لحفظ الصوت دون استهلاك مساحة السيرفر
+        # إزالة الرموز التعبيرية ومحددات الماركداون لتنظيف النطق الصوتي
+        clean_text = text_to_speak.replace("*", "").replace("#", "")
+        tts = gTTS(text=clean_text, lang='ar', slow=False)
         sound_file = io.BytesIO()
         tts.write_to_fp(sound_file)
-        
-        # عرض مشغل الصوت الأنيق المدمج بخصائص التشغيل والتحكم في الصوت والتمرير
         st.audio(sound_file, format='audio/mp3')
     except Exception as e:
-        st.warning("⚠️ مشغل الصوت واجه ضغطاً مؤقتاً، يمكنك قراءة التوضيح المكتوب في الأعلى ببساطة.")
+        st.warning("⚠️ مشغل الصوت واجه ضغطاً مؤقتاً، يمكنك قراءة التوضيح المكتوب ببساطة.")
 
 # ------------------------------------------------------------------------------
-# 5. بناء وتصميم الواجهة الأمامية للمستخدم (Frontend & App Layout)
+# 5. بناء وتصميم الواجهة الأمامية للمخدم (Frontend & App Layout)
 # ------------------------------------------------------------------------------
-
-# تصميم الهيدر الرئيسي للتطبيق باستخدام كروت جمالية متناسقة
 st.markdown("<h1 style='text-align: center; color: #1e4620;'>🕌 وكيل الأزهريين الذكي</h1>", unsafe_allow_html=True)
-st.markdown("<p style='text-align: center; color: #555; font-weight: bold; letter-spacing: 1px;'>Deputy of Al-Azhar Engine</p>", unsafe_allow_html=True)
-st.markdown("<p style='text-align: center; color: #777; font-size: 14px;'>مشروع خيري مستقل ومؤمن بالكامل لخدمة طلاب ومدرسي الأزهر الشريف عبر طراز Gemini 1.5 Flash</p>", unsafe_allow_html=True)
+st.markdown("<p style='text-align: center; color: #555; font-weight: bold; letter-spacing: 1px;'>Deputy of Al-Azhar Cloud Engine</p>", unsafe_allow_html=True)
+st.markdown("<p style='text-align: center; color: #777; font-size: 14px;'>مشروع خيري مستقل يعمل بكفاءة 100% عبر الخوادم السحابية لحماية هاتفك وراماتك</p>", unsafe_allow_html=True)
 st.write("---")
 
-# بناء القائمة الجانبية لإدارة البوابات وتأكيد حالة الاتصال بالسيرفر
+# بناء القائمة الجانبية
 with st.sidebar:
     st.markdown("<h3 style='text-align: center; color: #1e4620;'>🔐 لوحة التحكم والتوجيه</h3>", unsafe_allow_html=True)
     
-    # صندوق التحديد الذكي للتنقل بين حساب الطالب وحساب المعلم
     user_mode = st.selectbox(
         "اختر بوابة الدخول الحالية:",
         ["👤 بوابة الطالب الأزهري", "👨‍🏫 بوابة معلم أزهري"]
     )
     
     st.write("---")
-    # إشعار تأكيد الاتصال الآمن بجيميناي ومميزات الخطة
-    st.success("🔒 اتصال آمن: الخادم متصل بنموذج Gemini 1.5 Flash (1500 طلب مجاني يومياً بذاكرة مليونية).")
-    st.info("💡 نصيحة: ارفع كتاب المعهد أولاً، ثم تنقل بين الأزرار للحصول على أفضل النتائج.")
+    st.success("🔒 الخادم السحابي متصل بنموذج Qwen 2.5 الخارق (مجاني وسريع بالكامل بدون الحاجة لمفاتيح API مشفرة).")
+    st.info("💡 نصيحة: ارفع كتاب المعهد أولاً، ثم تنقل بين الأزرار للحصول على نتائجك.")
 
-# صندوق رفع ملفات كتب المعهد المشترك في الواجهة الرئيسية
+# صندوق رفع الملفات
 uploaded_file = st.file_uploader(
     "قم برفع كتاب المعهد، المذكرة الرسمية، أو مقرر المادة بصيغة (PDF):", 
     type=["pdf"]
 )
 
-# التحقق من حالة الملف المرفوع وبناء السياق التلقائي
 if uploaded_file is not None:
     with st.spinner("📄 جاري تشريح صفحات كتاب المعهد واستخراج النصوص بدقة أكاديمية..."):
         book_context = extract_text_from_pdf(uploaded_file)
-    st.toast("تمت قراءة الكتاب وتخزينه في ذاكرة الوكيل المؤقتة بنجاح! 🎉", icon="✅")
+    st.toast("تمت قراءة الكتاب وتخزينه في الذاكرة السحابية بنجاح! 🎉", icon="✅")
 else:
     book_context = ""
 
 # ------------------------------------------------------------------------------
-# 6. تفعيل البوابات البرمجية والعمليات الذكية بناءً على وضع المستخدم
+# 6. تفعيل البوابات بناءً على خيار المستخدم
 # ------------------------------------------------------------------------------
 
-# === أولاً: تشغيل منظومة بوابة الطالب الأزهري ===
+# === أولاً: بوابة الطالب الأزهري ===
 if user_mode == "👤 بوابة الطالب الأزهري":
     st.subheader("📚 رفيـقك الذكي للمذاكـرة وتوقعـات البوكلـيت")
-    st.write("مرحباً بك يا غالي في حاسوبك التعليمي. ارفع مقرر درسك، واطلب ما تريد من الوكيل الآن لتجاوز الملل وضمان التفوق:")
+    st.write("مرحباً بك يا غالي. ارفع مقرر درسك، واطلب ما تريد من الوكيل الآن لتجاوز الملل وضمان التفوق:")
     
-    # الصندوق النصي لاستقبال استفسارات الطالب
     student_query = st.text_input("اكتب سؤالك الفقهي أو النحوي، أو النقطة الصعبة التي تحتاج شرحها في هذا الدرس:")
     
-    # تقسيم الأزرار التفاعلية إلى عمودين متناسقين هندسياً
     col1, col2 = st.columns(2)
     
     with col1:
         if st.button("💡 اشرح لي الدرس ببساطة"):
             if book_context and student_query:
-                with st.spinner("🤖 يقوم الوكيل الآن بصياغة الشرح والتبسيط عبر جيميناي..."):
-                    reply = get_gemini_answer(f"اشرح لي ببساطة الدرس وأجب عن هذا السؤال بالتفصيل: {student_query}", book_context, user_mode)
+                with st.spinner("🤖 يقوم الوكيل الآن بصياغة الشرح والتبسيط سحابياً..."):
+                    reply = get_cloud_answer(f"اشرح لي ببساطة الدرس وأجب عن هذا السؤال بالتفصيل: {student_query}", book_context, user_mode)
                     st.success(reply)
-                    
                     st.markdown("### 🎧 استمع إلى الشرح الصوتي المباشر للوكيل:")
                     text_to_speech_player(reply)
             else:
@@ -193,32 +155,28 @@ if user_mode == "👤 بوابة الطالب الأزهري":
         if st.button("📝 توليد أسئلة بوكليت متوقعة"):
             if book_context:
                 with st.spinner("🤖 جاري قراءة السياق وتوليد أهم أسئلة امتحانات البوكليت المتوقعة..."):
-                    reply = get_gemini_answer("استخرج من هذا النص المرفق 3 أسئلة امتحانات متوقعة بنظام البوكليت الأزهري الرسمي (مثال: ما الحكم مع التعليل، علل لما يأتي، اذكر الدليل الشرعي أو العلمي) متبوعة بالإجابات النموذجية الكاملة والمنظمة لكل سؤال.", book_context, user_mode)
+                    reply = get_cloud_answer("استخرج من هذا النص المرفق 3 أسئلة امتحانات متوقعة بنظام البوكليت الأزهري الرسمي (مثال: ما الحكم مع التعليل، علل لما يأتي، اذكر الدليل الشرعي أو العلمي) متبوعة بالإجابات النموذجية الكاملة والمنظمة لكل سؤال.", book_context, user_mode)
                     st.info(reply)
-                    
                     st.markdown("### 🎧 استمع إلى الأسئلة المتوقعة وإجاباتها:")
                     text_to_speech_player(reply)
             else:
                 st.warning("⚠️ تنبيه: رجاءً ارفع ملف كتاب المعهد (PDF) أولاً لتوليد أسئلة الامتحان منه.")
 
-# === ثانياً: تشغيل منظومة بوابة المعلم الأزهري ===
+# === ثانياً: بوابة المعلم الأزهري ===
 elif user_mode == "👨‍🏫 بوابة معلم أزهري":
     st.subheader("👨‍🏫 مساعدك التربوي المتقدم لتنظيم المنهج وبنوك الأسئلة")
-    st.write("أهلاً وسهلاً بمشايخنا وأساتذتنا الأجلاء. هنا أداتك البرمجية لتوفير الوقت والجهد في تحضير الحصص وصياغة الاختبارات التقييمية لطلابكم:")
+    st.write("أهلاً وسهلاً بمشايخنا وأساتذتنا الأجلاء. هنا أداتك البرمجية لتوفير الوقت والجهد في تحضير الحصص واختبار الطلاب:")
     
-    # الصندوق النصي لاستقبال توجيهات المدرس
-    teacher_query = st.text_input("ما الدرس أو الجزئية المحددة التي ترغب في تحضيرها أو توزيعها اليوم يا مولانا؟")
+    teacher_query = st.text_input("ما الدرس أو الجزئية المحددة التي ترغب في تحضيرها اليوم يا مولانا؟")
     
-    # تقسيم أزرار المعلم لعمودين متوازيين
     col1, col2 = st.columns(2)
     
     with col1:
         if st.button("🗺️ وضع خطة تحضير وتوزيع للدرس"):
             if book_context:
                 with st.spinner("🤖 جاري صياغة خطة التحضير التربوية والوسائل المقترحة..."):
-                    reply = get_gemini_answer("قم بعمل تحضير دراسي نموذجي تربوي مفصل لهذا النص يحتوي على الأهداف السلوكية الثلاثة (معرفية، وجدانية، مهارية)، واقترح وسيلة تعليمية أو فكرة مبتكرة ومبسطة لشرح المعلم الدرس وتوصيل المعلومة بكفاءة لعقول الطلاب.", book_context, user_mode)
+                    reply = get_cloud_answer("قم بعمل تحضير دراسي نموذجي تربوي مفصل لهذا النص يحتوي على الأهداف السلوكية الثلاثة (معرفية، وجدانية، مهارية)، واقترح وسيلة تعليمية أو فكرة مبتكرة ومبسطة لشرح المعلم الدرس وتوصيل المعلومة بكفاءة لعقول الطلاب.", book_context, user_mode)
                     st.success(reply)
-                    
                     st.markdown("### 🎧 استمع إلى التحضير الصوتي التعليمي:")
                     text_to_speech_player(reply)
             else:
@@ -228,9 +186,8 @@ elif user_mode == "👨‍🏫 بوابة معلم أزهري":
         if st.button("🔍 ابتكار اختبار شهري للمادة"):
             if book_context:
                 with st.spinner("🤖 جاري صياغة وبناء أسئلة الاختبار الشامل ومفتاح الحل..."):
-                    reply = get_gemini_answer("اصنع اختباراً شهرياً منوعاً وشاملاً لتقييم استيعاب وفهم الطلاب لهذا النص، على أن يكون مقسماً بدقة وبشكل منظم إلى أسئلة مقالية، أسئلة موضوعية (صح وخطأ)، وأسئلة اختيار من متعدد، مع كتابة نموذج الإجابة التفصيلي ومفتاح الحل لكل سؤال لراحة المعلم.", book_context, user_mode)
+                    reply = get_cloud_answer("اصنع اختباراً شهرياً منوعاً وشاملاً لتقييم استيعاب وفهم الطلاب لهذا النص، على أن يكون مقسماً بدقة وبشكل منظم إلى أسئلة مقالية، أسئلة موضوعية (صح وخطأ)، وأسئلة اختيار من متعدد، مع كتابة نموذج الإجابة التفصيلي ومفتاح الحل لكل سؤال لراحة المعلم.", book_context, user_mode)
                     st.info(reply)
-                    
                     st.markdown("### 🎧 استمع إلى بنك الأسئلة والاختبار الشهري:")
                     text_to_speech_player(reply)
             else: