| name | whisper-arabic |
| description | Arabic speech-to-text transcription using OpenAI Whisper |
| version | 1.0.0 |
| author | Mousa Abu Mazin |
| license | MIT |
| platforms | ["linux","macos"] |
| prerequisites | {"commands":["whisper","ffmpeg"],"env_vars":["OPENAI_API_KEY"]} |
| metadata | {"hermes":{"tags":["media","speech-to-text","whisper","arabic"]}} |
تحويل الصوت إلى نص عربي
Whisper (OpenAI — محلي)
تفريغ ملف صوتي
whisper AUDIO_FILE --language Arabic --model medium --output_format txt
النماذج المتاحة
| النموذج | الحجم | الدقة | السرعة |
|---|
tiny | 39M | منخفضة | سريع جدا |
base | 74M | مقبولة | سريع |
small | 244M | جيدة | متوسط |
medium | 769M | عالية | بطيء |
large-v3 | 1.5G | أعلى | بطيء جدا |
الأفضل للعربي: medium (توازن بين الدقة والسرعة)
تفريغ مع timestamps
whisper AUDIO_FILE --language Arabic --model medium --output_format srt
تفريغ من فيديو
ffmpeg -i VIDEO_FILE -vn -acodec pcm_s16le -ar 16000 -ac 1 audio.wav
whisper audio.wav --language Arabic --model medium
API (OpenAI Cloud)
curl -s -X POST "https://api.openai.com/v1/audio/transcriptions" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-F file=@AUDIO_FILE \
-F model="whisper-1" \
-F language="ar"
متى تستخدم
- المستخدم يرسل ملف صوتي ويريد النص
- يريد تفريغ محاضرة أو خطبة
- يريد ترجمة صوتية (تفريغ + ترجمة)
- يريد عمل subtitles لفيديو عربي
القواعد
- نبّه أن اللهجات قد تقلل الدقة — الفصحى أدق
- للملفات الطويلة (>30 دقيقة) اقترح تقسيم الملف أولا
- إذا طلب تفريغ + ترجمة، استخدم whisper ثم skill translate