Upload 17 files

.dockerignore

@@ -0,0 +1,18 @@
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+*.log
+.git
+.github
+.gitignore
+.env
+.venv
+venv
+*.ipynb
+node_modules
+dist
+build
+tests
+# Not needed at runtime; index already built
+university_data_arabic/

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+vectorstores/db/chroma.sqlite3 filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1
+
+WORKDIR /app
+
+COPY requirements.txt /app/
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . /app
+
+EXPOSE 7860
+
+CMD ["sh", "-c", "uvicorn main:app --host 0.0.0.0 --port ${PORT:-7860}"]
+

README.md

@@ -1,11 +1,45 @@
----
-title: HNU Final
-emoji: 📉
-colorFrom: gray
-colorTo: pink
-sdk: docker
-pinned: false
-license: mit
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Helwan National University Chatbot API (RAG)
+
+Small FastAPI service that serves a RAG chatbot in Arabic using Google Generative AI (Gemini) and a local Chroma vector store built from Markdown content.
+
+## Requirements
+
+- Python 3.11
+- A Google API key with access to Gemini
+  - Create a key and copy it from the Google AI Studio dashboard.
+
+## Environment
+
+Create a `.env` file in the project root:
+
+```bash
+GOOGLE_API_KEY=your_google_api_key
+```
+
+## Build the vector store (once, locally)
+
+```bash
+pip install -r requirements.txt
+python create_vector_store.py
+```
+
+This generates the persisted Chroma index under `vectorstores/db/` which the API loads at startup. You can commit this directory to your repo so it is available in deployments.
+
+## Run locally
+
+```bash
+uvicorn main:app --host 0.0.0.0 --port 7860
+```
+
+Open `http://localhost:7860/` to verify the health endpoint.
+
+## Deploy to Hugging Face Spaces (Docker)
+
+1. Create a new Space and select the SDK: Docker.
+2. Push your repo files including `Dockerfile`, `requirements.txt`, `main.py`, `create_vector_store.py`, and the built `vectorstores/db/` directory.
+3. In the Space Settings → “Secrets”, add a secret named `GOOGLE_API_KEY` with your key.
+4. The container will start and bind to the port provided by Spaces automatically via `${PORT}`.
+
+### Build context size
+
+The `.dockerignore` excludes the raw data in `university_data_arabic/` to keep the image small. Ensure `vectorstores/db/` is present in the repository so the Space can serve immediately without rebuilding the index.

create_vector_store.py

@@ -0,0 +1,67 @@
+# create_vector_store.py
+from langchain_community.document_loaders import DirectoryLoader, TextLoader
+from langchain.text_splitter import RecursiveCharacterTextSplitter
+from langchain_community.vectorstores import Chroma
+from langchain_google_genai import GoogleGenerativeAIEmbeddings
+from dotenv import load_dotenv
+import os
+import shutil
+
+# --- إعدادات المشروع ---
+DATA_PATH = "university_data_arabic"
+DB_PATH = "vectorstores/db/"
+# نستخدم تضمينات جوجل المستضافة لتقليل حجم الحزم وعدم تحميل نماذج محلياً
+EMBEDDING_MODEL_NAME = "models/text-embedding-004"
+# ---------------------
+
+def build_vector_store():
+    """
+    يقوم هذا السكربت ببناء قاعدة البيانات المعرفية (Vector Store)
+    من ملفات الماركداون الموجودة في مجلد البيانات.
+    """
+    # تحميل المتغيرات البيئية (مثل GOOGLE_API_KEY)
+    load_dotenv()
+    # التأكد من وجود مجلد البيانات
+    if not os.path.exists(DATA_PATH):
+        print(f"خطأ: مجلد البيانات '{DATA_PATH}' غير موجود. يرجى إنشاؤه ووضع ملفات البيانات بداخله.")
+        return
+
+    # تنظيف قاعدة البيانات القديمة إذا كانت موجودة لضمان التحديث
+    if os.path.exists(DB_PATH):
+        print(f"يتم حذف قاعدة البيانات القديمة في {DB_PATH}")
+        shutil.rmtree(DB_PATH)
+
+    # 1. تحميل كل ملفات .md من مجلد البيانات
+    print(f"يتم تحميل الملفات من المسار: {DATA_PATH}...")
+    loader = DirectoryLoader(DATA_PATH, glob="**/*.md", loader_cls=TextLoader, loader_kwargs={'encoding': 'utf-8'}, show_progress=True)
+    documents = loader.load()
+    if not documents:
+        print("لم يتم العثور على أي ملفات. يرجى التأكد من وجود ملفات .md في مجلد البيانات.")
+        return
+
+    # 2. تقسيم المستندات إلى أجزاء (chunks) أصغر
+    print("يتم تقسيم المستندات إلى أجزاء أصغر...")
+    text_splitter = RecursiveCharacterTextSplitter(chunk_size=1000, chunk_overlap=200)
+    chunked_documents = text_splitter.split_documents(documents)
+    
+    # 3. إنشاء دالة التضمين باستخدام واجهة جوجل (عن بعد)
+    # لا يتم تحميل أي نموذج محلياً، مما يقلل المساحة المطلوبة بشكل كبير
+    print(f"يتم تهيئة تضمينات جوجل: {EMBEDDING_MODEL_NAME}...")
+    embedding_model = GoogleGenerativeAIEmbeddings(
+        model=EMBEDDING_MODEL_NAME
+    )
+    
+    # 4. إنشاء قاعدة بيانات ChromaDB وحفظها على الجهاز
+    print(f"يتم إنشاء قاعدة البيانات المعرفية في المسار: {DB_PATH}...")
+    vector_store = Chroma.from_documents(
+        documents=chunked_documents,
+        embedding=embedding_model,
+        persist_directory=DB_PATH
+    )
+    print("-----------------------------------------")
+    print("✅ تم إنشاء قاعدة البيانات بنجاح! ✅")
+    print("-----------------------------------------")
+
+
+if __name__ == "__main__":
+    build_vector_store()

main.py

@@ -0,0 +1,105 @@
+# main.py
+import os
+from fastapi import FastAPI, HTTPException
+from fastapi.responses import StreamingResponse
+from langchain_google_genai import ChatGoogleGenerativeAI
+from langchain.prompts import PromptTemplate
+from langchain.schema.runnable import RunnablePassthrough
+from langchain.schema.output_parser import StrOutputParser
+from langchain_community.vectorstores import Chroma
+from langchain_google_genai import GoogleGenerativeAIEmbeddings
+from dotenv import load_dotenv
+from pydantic import BaseModel
+from fastapi.middleware.cors import CORSMiddleware
+
+# --- Load API keys ---
+load_dotenv()
+
+# --- Project Settings ---
+DB_PATH = "vectorstores/db/"
+EMBEDDING_MODEL_NAME = "models/text-embedding-004"
+LLM_MODEL = "gemini-pro-latest" # Change to "gemini-1.5-pro" if you don't have access to Gemini Pro
+
+# --- Initialize FastAPI app ---
+app = FastAPI(
+    title="Helwan University Chatbot API",
+    description="An API for the Helwan National University chatbot using a RAG system.",
+    version="1.0.0"
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# --- Load RAG components on startup ---
+if not os.path.exists(DB_PATH):
+    raise FileNotFoundError(f"Database not found at: {DB_PATH}. Please run 'create_vector_store.py' first.")
+
+print("Loading AI models and database...")
+embedding_model = GoogleGenerativeAIEmbeddings(
+    model=EMBEDDING_MODEL_NAME
+)
+vector_db = Chroma(persist_directory=DB_PATH, embedding_function=embedding_model)
+llm = ChatGoogleGenerativeAI(
+    model=LLM_MODEL,
+    temperature=0.3,
+    convert_system_message_to_human=True
+)
+retriever = vector_db.as_retriever(search_kwargs={"k": 4})
+
+# --- Corrected and cleaned prompt template ---
+prompt_template = """
+أنت مساعد ذكي ومحترف تابع لجامعة حلوان الأهلية. مهمتك هي الإجابة على أسئلة المستخدمين بدقة وود.
+بناءً على السياق التالي، قم بمهمتين:
+
+1.  **الإجابة على السؤال:** قدم إجابة وافية على سؤال المستخدم بناءً على المعلومات المتاحة في السياق فقط. ابدأ دائمًا ردك بـ "أهلاً بك في جامعة حلوان الأهلية." إذا كانت المعلومة غير موجودة، قل بأدب "ليس لدي معلومات كافية حول هذا الموضوع حاليًا". لا تخترع إجابات. رد باللغة العربية فقط.
+
+2.  **اقتراح أسئلة:** بعد الإجابة، اقترح 3 أسئلة تالية ذات صلة قد يهتم بها المستخدم.
+
+استخدم الفاصل '---' للفصل بين إجابتك والأسئلة المقترحة.
+
+السياق:
+{context}
+
+السؤال:
+{question}
+
+الإجابة والأسئلة المقترحة:
+"""
+PROMPT = PromptTemplate(template=prompt_template, input_variables=["context", "question"])
+
+rag_chain = (
+    {"context": retriever, "question": RunnablePassthrough()}
+    | PROMPT
+    | llm
+    | StrOutputParser()
+)
+print("✅ All components loaded successfully. API is ready.")
+
+# --- API Endpoints ---
+
+class ChatRequest(BaseModel):
+    query: str
+
+async def stream_generator(query: str):
+    try:
+        async for chunk in rag_chain.astream(query):
+            yield chunk
+    except Exception as e:
+        # Generic error handler for any issue
+        print(f"!!! An unexpected error occurred: {e}")
+        yield "عذرًا، حدث خطأ ما. يرجى المحاولة مرة أخرى.---"
+
+@app.get("/")
+def read_root():
+    return {"status": "Helwan University Chatbot API is running"}
+
+@app.post("/chat/stream")
+async def chat_stream(request: ChatRequest):
+    if not request.query:
+        raise HTTPException(status_code=400, detail="Query cannot be empty")
+    return StreamingResponse(stream_generator(request.query), media_type="text/plain; charset=utf-8")

requirements.txt

@@ -0,0 +1,10 @@
+fastapi>=0.110,<1.0
+uvicorn>=0.23,<1.0
+langchain>=0.2,<1.0
+langchain-community>=0.2,<1.0
+langchain-text-splitters>=0.2,<1.0
+chromadb>=0.5,<1.0
+langchain-google-genai>=2.0,<3.0
+google-genai>=1.0,<2.0
+python-dotenv>=1.0,<2.0
+pydantic>=2.6,<3.0

university_data_arabic/academic_programs_highlights.md

@@ -0,0 +1,15 @@
+# نماذج من البرامج الدراسية المتميزة
+
+## برنامج هندسة النظم الذكية (كلية الهندسة)
+- **نبذة عن البرنامج:** هو برنامج مزدوج بالتعاون مع جامعة Uninettuno الإيطالية. يجمع بين هندسة الحاسبات، الإلكترونيات، نظم الاتصالات، والذكاء الاصطناعي.
+- **ماذا سيعمل الخريج؟** يؤهل البرنامج الخريجين للعمل في مجالات متعددة مثل أنظمة الروبوتات، المدن الذكية، وتطبيقات الذكاء الاصطناعي.
+
+## برنامج علوم البيانات (كلية الحاسب وتكنولوجيا المعلومات)
+- **نبذة عن البرنامج:** يهدف البرنامج إلى تأهيل الخريجين للتعامل مع البيانات الضخمة وتحليلها.
+- **ماذا سيعمل الخريج؟** يعمل الخريج في وظائف مطلوبة بشدة مثل مهندس بيانات (Data Engineer) وعالم بيانات (Data Scientist).
+
+## برنامج تكنولوجيا المختبرات الطبية (كلية تكنولوجيا العلوم الصحية التطبيقية)
+- **نبذة عن البرنامج:** هو برنامج تخصصي يؤهل الخريجين للعمل كمعاونين للمتخصصين في المعامل الطبية وإجراء التحاليل والفحوصات.
+
+## برامج كلية الفنون والفنون التطبيقية
+- **أمثلة على البرامج:** برنامج الرسوم المتحركة والمؤثرات البصرية، وبرنامج التصميم الداخلي.

university_data_arabic/admissions_and_application.md

@@ -0,0 +1,23 @@
+# شروط القبول والتقديم
+
+## الشهادات المقبولة
+- الثانوية العامة المصرية.
+- الشهادات المعادلة العربية والأجنبية.
+- الثانوية الأزهرية.
+- شهادات مدارس النيل (Nile).
+- شهادات مدارس المتفوقين في العلوم والتكنولوجيا (STEM).
+
+## شروط التقديم
+- يجب أن يكون الطالب قد حصل على شهادة الثانوية في العام الدراسي الحالي أو العام الدراسي الماضي فقط.
+
+## طريقة التقديم
+- يتم التقديم بشكل إلكتروني فقط عبر الموقع الرسمي للجامعة. لا يتم القبول عبر مكتب التنسيق الحكومي.
+
+## الأوراق والمستندات المطلوبة
+- أصل شهادة الثانوية العامة وصورة منها.
+- أصل شهادة الميلاد وصورة منها.
+- أصل بطاقة الرقم القومي وصورة منها.
+- بطاقة الترشيح الصادرة من موقع التنسيق.
+- استمارة الكشف الطبي المطبوعة من موقع الجامعة.
+- عدد 6 صور شخصية حديثة.
+- نموذج 2 جند وبطاقة 6 جند (أو 7 جند) للطلاب الذكور.

university_data_arabic/faculty_of_engineering.md

@@ -0,0 +1,29 @@
+# كلية الهندسة - جامعة حلوان الاهلية
+
+تعتبر كلية الهندسة بجامعة حلوان الاهلية من الكليات الرائدة في مجال التعليم الهندسي في المنطقة، وتشتهر ببرامجها ذات الكفاءة العالية و المتطورة لمواكبة ثورة التكنولوجيا الحديثة.
+
+## المصاريف الدراسية
+تبلغ المصاريف الدراسية السنوية للبرامج  حوالي **70,000 جنية مصري**
+
+## البرامج المتاحة
+
+تقدم الكلية العديد من البرامج بنظام الساعات المعتمدة، ومنها:
+
+### 1. برنامج هندسة الانظمة الذكية
+- **نبذة عن البرنامج:** يهدف البرنامج إلى إعداد مهندسين متخصصين في تصميم وتطوير أنظمة الاتصالات والشبكات وهاردوير وسوفتوير الحاسبات.
+- **أهم الكورسات:** شبكات الحاسب، تصميم الدوائر الرقمية، نظم التشغيل، الذكاء الاصطناعي، أمن المعلومات.
+- **ماذا سيعمل الخريج؟** يعمل الخريج كمهندس شبكات، مطور برمجيات، مهندس نظم مدمجة (Embedded Systems)، متخصص في أمن المعلومات، أو مطور تطبيقات.
+
+### 2. برنامج هندسة العمارة وتكنولوجيا البناء
+- **نبذة عن البرنامج:** يركز البرنامج على دمج فن العمارة مع أحدث تقنيات البناء والتشييد، وتصميم المباني الذكية والمستدامة.
+- **أهم الكورسات:** التصميم المعماري، تكنولوجيا البناء، أنظمة التحكم البيئي، تاريخ ونظريات العمارة، إدارة المشروعات.
+- **ماذا سيعمل الخريج؟** يعمل الخريج كمهندس معماري، مدير مشروعات، مصمم حضري، أو استشاري في مجال البناء المستدام.
+
+### 3. برنامج هندسة البترول والبتروكيماويات
+- **نبذة عن البرنامج:** يختص البرنامج بدراسة استكشاف واستخراج النفط والغاز، بالإضافة إلى عمليات تصنيع وتكرير البتروكيماويات.
+- **أهم الكورسات:** هندسة المكامن، هندسة الحفر، كيمياء البترول، عمليات تكرير البترول.
+- **ماذا سيعمل الخريج؟** يعمل الخريج كمهندس بترول في شركات التنقيب، أو مهندس عمليات في مصانع البتروكيماويات والتكرير.
+
+## أسئلة شائعة
+### هل برامج الكلية معتمدة دوليًا؟
+نعم، العديد من برامج الكلية حاصلة على الاعتماد الدولي مما يتيح للخريجين فرص عمل عالمية.

university_data_arabic/helwan_national_university_overview.md

@@ -0,0 +1,31 @@
+# عن جامعة حلوان الأهلية
+
+جامعة حلوان الأهلية هي جامعة أهلية مصرية غير هادفة للربح، تأسست بموجب القرار الجمهوري رقم 43 لسنة 2022. تقع الجامعة داخل حرم جامعة حلوان الحكومية بمنطقة عين حلوان.
+
+## رئيس الجامعة
+يتولى رئاسة الجامعة حاليًا الأستاذ الدكتور **سيد قنديل**. يسعى سيادته لتطوير الجامعة أكاديميًا وبحثيًا ورفع تصنيفها بين الجامعات العالمية.
+
+## الفرق بين الجامعة الأهلية والحكومية
+- **الهدف:** هي جامعة غير ربحية تابعة للدولة وموجهة لخدمة المجتمع.
+- **نظام التعليم:** تركز بشكل كبير على الجانب العملي والتطبيقي (قد يصل إلى 70%)، مع تنظيم زيارات ميدانية مستمرة للمواقع والمصانع.
+- **نظام القبول:** لديها تنسيق داخلي خاص بها، ويتم القبول بناءً على أعلى المجاميع من بين المتقدمين الذين استوفوا الحد الأدنى للقبول.
+
+## الكليات المتاحة
+- كلية الطب البشري
+- كلية طب الأسنان
+- كلية العلوم الانسانية
+- كلية العلاج الطبيعي
+- كلية الهندسة
+- كلية علوم الحاسب وتكنولوجيا المعلومات
+- كلية تكنولوجيا العلوم الصحية التطبيقية
+- كلية العلوم
+- كلية العلوم الإنسانية والتجارة وإدارة الأعمال
+- كلية الفنون والفنون التطبيقية
+
+## أسئلة شائعة
+
+### أين تقع جامعة حلوان الاهلية؟
+يقع الحرم الرئيسي لجامعة القاهرة في مدينة الجيزة، مصر.
+
+### كيف يمكن التواصل مع إدارة الجامعة؟
+يمكن التواصل عبر الموقع الرسمي للجامعة أو من خلال أرقام الهواتف المتاحة على الموقع.

university_data_arabic/student_services_and_facilities.md

@@ -0,0 +1,12 @@
+# الخدمات والمرافق الطلابية
+
+## المكتبة
+- يمكن لطلاب جامعة حلوان الأهلية استخدام المكتبة الرقمية بجامعة حلوان الحكومية.
+- تقدم المكتبة خدمات بحثية متقدمة وورش عمل متنوعة للطلاب.
+
+## السكن الطلابي
+- تتوفر خيارات إقامة مخصصة للطلاب الوافدين.
+- يمكن التقديم للحصول على سكن طلابي إلكترونيًا عبر منصة "مسكني".
+
+## الخدمات الإلكترونية
+- توفر الجامعة بوابات وخدمات إلكترونية للطلاب لتسهيل الوصول إلى الخدمات الأكاديمية والجداول الدراسية.

university_data_arabic/tuition_and_scholarships.md

@@ -0,0 +1,24 @@
+# المصروفات الدراسية والمنح
+
+## المصروفات للعام الدراسي 2025/2026 (للطلاب المصريين)
+**ملاحظة هامة:** هذه المصروفات لا تشمل أي رسوم إدارية أو خدمية إضافية.
+
+- **الطب البشري:** 150,000 جنيه مصري
+- **طب الأسنان:** 130,000 جنيه مصري
+- **العلوم الانسانية:** 135,000 جنيه مصري
+- **العلاج الطبيعي:** 105,000 جنيه مصري
+- **الهندسة:** 70,000 جنيه مصري
+- **علوم الحاسب وتكنولوجيا المعلومات:** 80,000 جنيه مصري
+- **العلوم:** 60,000 جنيه مصري
+- **الفنون والفنون التطبيقية:** 60,000 جنيه مصري
+- **تكنولوجيا العلوم الصحية التطبيقية:** 55,000 جنيه مصري
+- **كلية العلوم الانسانية والتجارة وادارة الاعمال :** 60,000 جنيه مصري
+
+
+## المنح والخصومات
+- **منح التفوق الأكاديمي:** توجد منح مخصصة للطلاب المتفوقين أكاديميًا. يشترط حصول الطالب المصري على نسبة لا تقل عن 85% في الثانوية العامة.
+- **منح الطلاب الوافدين:** تتوفر منح خاصة للطلاب الدوليين (60 منحة للعام 2024/2025)، تشمل منحًا كاملة أو تخفيض بنسبة 50%.
+
+
+
+

vectorstores/db/c00977b0-4a70-4fd4-b4a8-a6821909af37/data_level0.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a13e72541800c513c73dccea69f79e39cf4baef4fa23f7e117c0d6b0f5f99670
+size 3212000

vectorstores/db/c00977b0-4a70-4fd4-b4a8-a6821909af37/header.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0ec6df10978b056a10062ed99efeef2702fa4a1301fad702b53dd2517103c746
+size 100

vectorstores/db/c00977b0-4a70-4fd4-b4a8-a6821909af37/length.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:121a39651fded84cf110c98959e3e4be8868cafec85cf0364d29a09e25fa78fd
+size 4000

vectorstores/db/c00977b0-4a70-4fd4-b4a8-a6821909af37/link_lists.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
+size 0

vectorstores/db/chroma.sqlite3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5aaf6edb16e28e236a81b77fb201ab6323f3427d0d53874a571637cea477dfe2
+size 344064