README.md

metadata

title: Voice AI Assistant
emoji: 🎙️
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.50.0
app_file: app.py
pinned: false

🎙️ المساعد الذكي المرن (نص / صوت)

مساعد ذكاء اصطناعي يدمج:

• Whisper (faster-whisper) لتفريغ الصوت إلى نص
• Qwen2.5-3B-Instruct (GGUF عبر llama-cpp-python) لتوليد الردود

ملاحظات هامة قبل التشغيل على Hugging Face Spaces

1. اختر Hardware مناسب: الموديلين (Whisper + Qwen 3B) يحتاجان ذاكرة لا بأس بها.

   • الـ Free CPU tier (2 vCPU / 16GB) ممكن يشتغل لكن بسرعة استجابة منخفضة نسبياً.
   • لو عايز سرعة أفضل، رقّي إلى CPU upgrade أو GPU من إعدادات الـ Space.

2. زمن أول تشغيل (Cold Start): تحميل موديل Qwen (حوالي 1.8 جيجا) من Hugging Face Hub عند أول تشغيل للـ Space قد يستغرق بعض الوقت. الموديل يُخزَّن مؤقتاً بعد ذلك.

3. اللغة: تفريغ الصوت مضبوط افتراضياً على العربية (language="ar") في دالة audio_model.transcribe. لو احتجت دعم لغات أخرى أو اكتشاف تلقائي، عدّل أو احذف هذا الباراميتر.

4. الملفات المطلوبة في الـ Space:

   • app.py (الكود الرئيسي)
   • requirements.txt (المكتبات المطلوبة)
   • README.md (هذا الملف، يحتوي على إعدادات الـ Space في الأعلى)

كيفية الرفع

1. أنشئ Space جديد من نوع Gradio على Hugging Face.
2. ارفع الملفات الثلاثة (app.py, requirements.txt, README.md) في جذر الـ Space.
3. انتظر حتى ينتهي البناء (Build) ثم استخدم الواجهة مباشرة.