README.md

---
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) ثم استخدم الواجهة مباشرة.