CoolFace
Apppublic

fatima200026/museum-saraya

sourceHugging Faceupdated 4mo agoView on Hugging Face
0likes
App README

🏛️ مرشد متحف السرايا الحمراء — النسخة المحدّثة (2)

مشروع مادة مقدمة الذكاء الاصطناعي الموقع + خادم Python (Flask) + ذكاء اصطناعي (scikit-learn + ImageHash)

✨ ما الجديد في هذه النسخة؟

1. 🖼️ ميزة التعرّف على الصور (Image Recognition)

يمكن للمستخدم الآن إرسال صورة لقطعة من قطع المتحف، وسيتعرّف عليها النظام ويعطي شرحاً عنها.

كيف تشتغل تقنياً:

  • —نستخدم Perceptual Hashing (pHash) عبر مكتبة imagehash
  • —نحسب بصمة فريدة لكل صورة في المتحف عند تشغيل السيرفر
  • —عند رفع صورة من المستخدم، نحسب بصمتها ونقارنها مع كل البصمات
  • —النتيجة الأقرب (أقل مسافة Hamming) هي القطعة المطابقة

2. 🌐 دعم لغتين (عربي / إنجليزي)

  • —زر تبديل اللغة في الشات (يبدّل بين AR و EN)
  • —كل البيانات مترجمة (الأسماء، الأوصاف، الأقسام، القاعات)
  • —المرشد الذكي يفهم الأسئلة بالعربية والإنجليزية معاً

3. 🔒 الكلمات المفتاحية أصبحت داخلية

  • —لم تعد تظهر للمستخدم في صفحة التفاصيل أو في الردود
  • —تُستخدم فقط داخل سيرفر Python لتحسين دقة البحث

4. 💬 رد افتراضي مخصّص عند عدم الإيجاد

عند سؤال غير موجود في البيانات يظهر:

"المعلومة غير متوفرة الآن، ولا يزال النظام في مرحلة التطوير."

5. 📊 مصدر بيانات محدّث

البيانات الآن مأخوذة من ملفات Word الجديدة (الطابق الأول مع الخريطة، الثاني، الثالث، الرابع، والمرافق)، مع صور حقيقية مستخرجة من الملفات.


📦 ملفات المشروع

museum_app/
├── server.py           ← خادم Flask + APIs (نص + صور)
├── data.py             ← بيانات المتحف (35 عنصر، AR + EN)
├── chatbot.py          ← المرشد الذكي (TF-IDF + Cosine)
├── requirements.txt    ← المكتبات (Flask، scikit-learn، Pillow، ImageHash)
├── README.md           ← هذا الملف
└── static/
    ├── index.html      ← الواجهة (+ زر اللغة + زر رفع صورة)
    ├── styles.css      ← التصميم (+ ستايل اللغة والصور)
    ├── app.js          ← المنطق (+ دعم اللغة + رفع الصور)
    ├── data.js         ← نفس البيانات للواجهة (بدون keywords)
    ├── mascot.js
    ├── manifest.json
    ├── sw.js
    └── images/         ← الصور الجديدة
        ├── F1.jpg, F2.jpg, F3.jpg, F4.jpg  ← خرائط الطوابق
        ├── F1-Mummy1.jpg, F1-Mummy2.jpg     ← مومياوات
        ├── F1-Greek.jpg, F1-Roman.jpg       ← قطع الطابق الأول
        ├── F2-Romanian{1..5}.jpg            ← قطع الطابق الثاني
        ├── F2-Bez6.jpg                      ← العصر البيزنطي
        ├── Sheikh_Abu_Bakr_Al_Maslati.jpg   ← الشيخ المسلاتي
        ├── Libyan_Sadra_Traditional_Jewelry.jpg
        ├── Ghadames_Traditional_House_Hall22.jpg
        ├── Omar_Mukhtar_Belongings.jpg
        ├── Iron_Meteorite.jpg
        ├── Desert_Experience.jpg
        ├── cafe.jpg, Mosque.jpg
        └── ... (الصور القديمة محفوظة احتياطياً)

🚀 كيف تشغّل المشروع

1) ثبّت المكتبات

bash
pip install -r requirements.txt

2) شغّل الخادم

bash
python server.py

سيظهر لك:

🤖 جاري تحميل المرشد الذكي...
✅ المرشد جاهز! (35 قطعة، ~3300 كلمة في القاموس)
🖼️  جاري بناء فهرس الصور...
✅ فهرس الصور جاهز! (29 صورة محملة)
📡 الموقع: http://localhost:5000

3) افتح المتصفح

http://localhost:5000

🔬 الـ API endpoints

العنوانالطريقةالوصف
/GETالموقع الرئيسي
/api/askPOSTإرسال سؤال نصي للمرشد
/api/identify-imagePOSTإرسال صورة للتعرف عليها
/api/itemsGETقائمة كل العناصر
/api/infoGETمعلومات النموذج

مثال: سؤال نصي

bash
curl -X POST http://localhost:5000/api/ask \
     -H "Content-Type: application/json" \
     -d '{"query": "Where is the Wan Muhuggiag mummy?", "lang": "en"}'

مثال: التعرف على صورة (base64)

bash
curl -X POST http://localhost:5000/api/identify-image \
     -H "Content-Type: application/json" \
     -d '{"image_base64": "data:image/jpeg;base64,/9j/...", "lang": "ar"}'

🧪 جرّب هذه الأسئلة في الشات

عربي:

  • —وين سبتيموس سيفيروس؟
  • —مومياء وان مهيجاج
  • —الصدرة الليبية
  • —البيت الغدامسي
  • —وين المقهى؟
  • —النيزك

English:

  • —Where is the Wan Muhuggiag mummy?
  • —Omar Mukhtar weapons
  • —Where is the cafe?
  • —Tell me about the Libyan Sadra

🛑 لإيقاف الخادم

اضغط Ctrl + C في الـ Terminal.