README.md

---
title: Multilingual TTS API
emoji: "🎙️"
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: "5.44.1"
python_version: "3.11"
app_file: app.py
pinned: false
license: mit
---

# 🎙️ Multilingual TTS — باكج كامل جاهز للرفع

هذا الباكج **مكتفٍ ذاتياً**: كود النموذج داخل `src/` — لا حاجة لـ
`pip install chatterbox-tts` (مصدر خطأ pkuseg) ولا لنسخ أي Space آخر.

## الرفع

1. أنشئ Space جديد: SDK = **Gradio**، Hardware = **ZeroGPU**
2. ارفع **كل** محتويات هذا المجلد كما هي (بما فيها مجلد src كاملاً):
   - الأسهل: صفحة الـ Space → Files → ⋮ → **Upload folder**
   - أو بسطر أوامر:
     ```bash
     pip install huggingface_hub
     hf upload USERNAME/SPACENAME . . --repo-type=space
     ```
3. ارفع صوتك المرجعي باسم `default_voice.wav` (10–20 ثانية، نظيف)
4. انتظر البناء ✅ (رسالة "pkuseg not available" في السجل = طبيعية)

## API لتطبيق الأندرويد

```
POST https://USERNAME-SPACENAME.hf.space/gradio_api/call/tts
{"data": ["النص هنا", "العربية (ar)", 0.5, 0.5, null]}
```
استخدم `TtsClientHF.kt` المرفق — يتكفل بالخطوات كاملة.

## لماذا نجح هذا الباكج حيث فشل السابق؟

| المشكلة السابقة | الحل هنا |
|---|---|
| `pip install chatterbox-tts` يجر pkuseg المعطوبة | الكود داخل src/ بدون pip |
| بايثون 3.13 بلا wheels لـ numpy القديمة | `python_version: "3.11"` في الترويسة |
| نقص einops و pyloudnorm | مضافة في requirements |