---
title: tts translate Alpha
emoji: ✈️🗣️
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
---

# ✈️ آلفا مترجم — مترجم و گوینده هوشمند چندزبانه

این ابزار متن شما را بین ده‌ها زبان ترجمه کرده و با صدای طبیعی (Edge-TTS مایکروسافت) می‌خواند.

## نکته مهم درباره‌ی پایداری (Uptime)

این پروژه از دو سرویس **رایگان و بدون کلید API** استفاده می‌کند:
- ترجمه: `deep-translator` (از طریق Google Translate)
- تبدیل متن به صدا: `edge-tts` (سرویس رایگان مایکروسافت)

هیچ Secret/API Key ای برای اجرا لازم نیست.

### چرا ممکن است اسپیس گاهی ری‌استارت شود؟
1. **پلن رایگان Hugging Face Spaces** منابع محدودی (CPU/RAM مشترک) دارد و پلتفرم ممکن است container را برای مدیریت منابع، به‌روزرسانی زیرساخت، یا در صورت رسیدن به سقف مصرف حافظه، ری‌استارت کند. این رفتار طبیعی پلن رایگان است و مستقل از کیفیت کد شماست.
2. سرویس رایگان Edge-TTS مایکروسافت گاهی زیر بار زیاد (درخواست‌های هم‌زمان بالا) خطای موقت `No audio was received` می‌دهد. کد فعلی این حالت را با **retry خودکار** و **محدودسازی تعداد درخواست هم‌زمان** (`TTS_CONCURRENCY_LIMIT`) مدیریت می‌کند تا این خطاها به بحران حافظه/کرش تبدیل نشوند.

### برای حداکثر پایداری توصیه می‌شود:
- در تنظیمات Space (Settings → Sleep time)، اگر پلن رایگان استفاده می‌کنید توجه کنید که Spaceهای CPU Basic رایگان ممکن است در نبود ترافیک بعد از مدتی خواب بروند؛ برای جلوگیری از خواب کامل باید سخت‌افزار **Persistent/Paid** انتخاب شود («Upgrade Space» در تنظیمات).
- متغیرهای محیطی زیر را می‌توانید در Settings → Variables تنظیم کنید تا بار سرویس را کنترل کنید:
  - `TTS_CONCURRENCY_LIMIT` (پیش‌فرض: 6) — تعداد درخواست هم‌زمان مجاز به Edge-TTS
  - `AUDIO_CACHE_MAX_MB` (پیش‌فرض: 300) — حداکثر حجم مجاز پوشه‌ی کش صوتی قبل از پاکسازی اضطراری

### مانیتورینگ
مسیر `/healthz` برای بررسی سلامت سرویس در دسترس است و در `Dockerfile` هم healthcheck داخلی تعریف شده است.

## نحوه استفاده
1. متن خود را وارد کنید.
2. زبان مبدا و مقصد و صدای دلخواه را انتخاب کنید.
3. (اختیاری) سرعت، حجم و گام صدا را در تنظیمات پیشرفته تغییر دهید.
4. روی دکمه‌ی ترجمه و تلفظ بزنید.

## وابستگی‌ها
همه‌ی نیازمندی‌ها در `requirements.txt` مشخص و توسط `Dockerfile` نصب می‌شوند.

---
ساخته شده با ❤️ — FastAPI · Edge-TTS · Google Translate