كلنا رأينا مشروع (المعلم القرآني) هذا المشروع المبارك المميز، الذي يسهل بشكل كبير قدرة الذكاء الاصطناعي لتقييم التلاوة عن طريق تطوير رسم صوتي للقرآن الكريم يصف كل قواعد التجويد وصفات الحروف.
يعتمد النموذج على تحليل التلاوة عبر ثلاثة مستويات:
- الفونيم: صحة نطق الحرف
- الصفة الصوتية: مطابقة صفة الحرف (همس، جهر، شدة…)
- حكم التجويد: تطبيق أحكام التجويد كالمد والغنة
لن اطيل عليكم في شرح هذا المشروع، لكن عندما رأيته، وفهمت عمق الفكرة الجديد وكيف انه هو الحل فعلاً وكلمة السر في (الفونيم)، قلت في نفسي هذا سوف يغير كل شيء، كيف نستفيد من هذا النموذج. لذلك اقترحت أن يقوم مطوري هذا النموذج بعمل خادم Backend يوفر API يمكن لمطوري تطبيقات القرآن الإستفادة من تقنيتهم بشكل بسيط (يجب أن يكون مدفوع حتى نضمن الإستمرارية وهذا ما تقوم به كل شركات الذكاء الاصطناعي)، بحيث ارسل رقم السورة والآية، الملف الصوتي لقرآة المستخدم وفي خلال ثانية واحدة ليس أكثر، يصل لي تقرير عن كل شيء لتقييم هذه التلاوة. والفائدة عظيمة. تخيل أنا كمستخدم اقرأ القرآن في المنزل وبعد الانتهاء من قرآة سورة أجد تقرير مفصل، يخبرني، عليك العمل على الغنة، فقد اخطأت في كلمة كذا، وكلمة كذا قمت بكسرها بدل فتحها، وهذا إستخدام واحد لهذا الـ API فهناك عدة استخدامت اخرى من تتبع قراءة القرآن بدقة، والمساعدة على الحفظ، والتسميع للمستخدم، تعليم أحكام التلاوة. وخيالك هو الحد.
لكن الحقيقة لم اطيق صبراً، وبما أن الموديل موجود قررت عمل ال API بنفسي، وسوف اجرب...
مقدمة عن المشروع
هذا المشروع عبارة عن اختبار وعرض عملي لكيفية نشر نموذج الذكاء الاصطناعي Quran Muaalem في بيئة إنتاج حقيقية، مع توفير تطبيق iOS بواجهة عربية جميلة تساعد على تحليل تلاوة القرآن الكريم واكتشاف الأخطاء.
---
تم بناء المشروع اعتمادًا على عمل obadx/quran-muaalem، وهو أول نموذج ذكاء اصطناعي قادر على تقييم التلاوة واكتشاف الأخطاء التجويدية، والسمات الصوتية (الصفات)، والانحرافات الصوتية.
ما الذي يوفره هذا المشروع؟
- واجهة API (FastAPI + Modal): واجهة برمجية جاهزة للنشر مع دعم الـ GPU عبر Modal.
- تطبيق iOS: واجهة استخدام عربية تعرض نتائج النموذج بشكل مبسّط ومفهوم للمستخدم.
المزايا
🚀 مزايا واجهة API (الخادم)
FastAPI لبناء واجهة REST واضحة وسريعة
نشر على Modal مع دعم الـ GPU والتشغيل عند الطلب
طريقتان للتحليل:
اكتشاف الأخطاء على مستوى:
إعدادات تجويد قابلة للتخصيص
تكلفة منخفضة (الدفع حسب استخدام الـ GPU فقط)
📱 مزايا تطبيق iOS
واجهة عربية حديثة وسهلة
تسجيل صوتي بضغطة واحدة
اختيار السورة والآية مع معاينة النص
تحليل واضح مبني على الكلمات:
تفاصيل متقدمة (اختيارية)
إعدادات للمدود والرواية
استخدام خط المصحف (Hafs Smart)
قاعدة بيانات قرآن كاملة للعمل دون إنترنت
البنية العامة للمشروع
┌─────────────────┐
│ تطبيق iOS │
│ (Swift/SwiftUI) │
└────────┬────────┘
│ HTTPS
┌────────▼────────┐
│ خادم FastAPI │
│ (Modal.com) │
└────────┬────────┘
│
┌────────▼────────┐
│ نموذج معلّم │
│ (660M params) │
└─────────────────┘
تسلسل العملية:
- يسجل المستخدم التلاوة عبر التطبيق
- يرسل التطبيق الصوت والآية إلى الـ API
- يقوم الخادم بتحليل الصوت والنص
- يجري النموذج المقارنة الصوتية والتجويدية
- يرسل الخادم النتائج بشكل منظّم
- يعرض التطبيق النتائج بطريقة مبسطة
خطوات الإعداد
المتطلبات
- Python 3.11 فما فوق، حساب Modal
- Xcode 15+ وجهاز iOS 17+
🐍 إعداد API على Modal
1. تثبيت Modal CLI
pip install modal
2. تسجيل الدخول
modal setup
3. النشر
cd main
modal deploy modal_app.py
4. اختبار الصحة
curl https://your-url.modal.run/health
📱 إعداد تطبيق iOS
1. فتح المشروع
cd Quran-Muaalem-Swift
open Quran-Muaalem-Swift.xcodeproj
2. تغيير رابط API
في ملف MuaalemAPI.swift:
private let baseURL = "https://your-url.modal.run"
3. التشغيل
- اختر الجهاز
- اضغط CMD + R
- وافق على إذن الميكروفون
كيفية الاستخدام
مثال استخدام API
curl -X POST "https://your-api.modal.run/api/analyze-by-verse" \
-F "audio=@recording.wav" \
-F "sura=1" \
-F "aya=2" \
-F "rewaya=hafs" \
-F "madd_monfasel_len=2" \
-F "madd_mottasel_len=4"
هيكل الاستجابة
{
"phonemes_text": "...",
"sifat": [...],
"reference": {"sura": 1, "aya": 2},
"phoneme_diff": [...],
"sifat_errors": [...],
"phonemes_by_word": [...]
}
استخدام التطبيق
- افتح التطبيق
- اختر السورة والآية
- اضغط زر التسجيل
- اقرأ الآية
- توقف لعرض النتائج
- اضغط على الأخطاء لمشاهدة الحروف
- افتح التفاصيل المتقدمة إن رغبت
هيكلة المشروع
.
├── main/ # خادم Python
│ ├── modal_app.py
│ ├── pyproject.toml
│ └── src/quran_muaalem/
│
├── Quran-Muaalem-Swift/ # تطبيق iOS
│ ├── Models/
│ ├── Services/
│ ├── Views/
│ ├── Data/
│ └── Fonts/
└── README.md
الرخصة والشكر
- المشروع مرخّص تحت MIT
- مبني على مشروع Quran Muaalem الأصلي
- الشكر لله أولًا، ثم للمساهمين في المشروع الأصلي
المساهمة
هذا المشروع هو لتقديم فكرة لمقدمي هذا النموذج، هذا المشروع يجب ان تحول لخدمة تقدم API، ويجب أن يقوم مطوري هذا المشروع أنفسهم بتقديم هذه الخدمة، لأن هذا سوف يصبح عملهم، هذا سوف يصبح خدمة مميزة لكل مسلمين العالم.
قدمت لمطوري هذا المشروع طريقة جديدة في عرض التقراير، المستخدم أو المطور يجب أن لا يرى ابداً (الفونيم) العثماني. المستخدم والمطور يحتاج إلى تقرير مثل المعروض هنا
الكلمة والاخطاء التي بها، وموقع الحرف الذي به الخطأ، هذا ما يفهمه المستخدم، وهذا الذي من الممكن أن ابني عليه تقارير ليحسن المستخدم من تلاوته للقرآن.
هذا التقرير الذي يقدمه في عرض مميزات التطبيق يجب ان يتغير، ويجب ان يصبح أكثر قرباً للمطورين.
في هذا المشروع وضعت كل هذا التصور، وهذا النموذج الآن سهل للتجربة، لكل ما عليك فعله نسخة الـRepo ثم استخدام رابط لموقع Modal يقدم لك 30$ مجاناً شهرياً كافي للتجربة.
Quran-Muaalem-iOS
خلاصة تجربتي
النموذج رائع، ولكنه يحتاج إلى الكثير من العمل ليخرج بالشكل الذي اتمناه، وأنا مرهق :) لذلك تركت هذا المشروع مفتوح المصدر للشباب، أو لاصحابه ليستفيدوا من الأفكار الذي قدمها. وأنا متاح ولدي فكرة جيدة عن كيفية تطوير هذا المشروع، ليكون افضل من ترتيل AI وافضل تطبيق على أي بيئة يخدم ملايين من المسلمين حول العالم.
نسأل الله أن ينفع بهذا العمل المسلمين حول العالم 🤲 وشكر خاص لمقدم هذا النموذج، وأنه تخطى مرحلة الأبحاث والأوراق للتنفيذ.
