الدرس 27: وضع الصوت
Tutorial 27: Voice Mode — easy-to-understand guide based on official docs
الدرس 27: وضع الصوت
مرحباً بعودتكم يا أصدقاء! اليوم سنتحدث عن واحدة من أروع الطرق لاستخدام Hermes: وضع الصوت. إذا كنت يوماً ما تمنيت التحدث مع مساعدك الذكي أثناء التجول، أو طهي العشاء، أو فقط لتتجنب لوحة المفاتيح، فهذا الدرس مخصص لك.
ما هو وضع الصوت؟
وضع الصوت يتيح لك التحدث مع Hermes بدلاً من الكتابة. إنه مثالي من أجل:
- سير عمل CLI بدون استخدام اليدين – كتابة الأكواد والبحث دون لمس لوحة المفاتيح
- ردود صوتية في Telegram أو Discord – احصل على ردود صوتية بجانب الرسائل النصية العادية
- قنوات Discord الصوتية المباشرة – قم بمحادثة حقيقية مع Hermes في دردشة صوتية
- التقاط الأفكار بسرعة – أمِل أفكارك بصوتك أثناء المشي أو جلسات العصف الذهني
أفضل جزء؟ إذا كنت تستخدم Nous Portal، ستحصل على كل من نموذج اللغة والنص-إلى-كلام من خلال تسجيل دخول OAuth واحد. لا حاجة لأي بيانات اعتماد إضافية!
ثلاث طرق لاستخدام الصوت
| الوضع | الأنسب لـ | المنصة |
|---|---|---|
| حلقة الميكروفون التفاعلية | الاستخدام الشخصي بدون استخدام اليدين | CLI |
| ردود صوتية في الدردشة | ردود منطوقة مع المراسلة | Telegram, Discord |
| بوت قناة صوتية مباشرة | محادثات جماعية | قنوات Discord الصوتية |
نصيحة احترافية: ابدأ بتشغيل وضع النص أولاً، ثم أضف الردود الصوتية، وأخيراً جرّب قنوات Discord الصوتية إذا كنت تريد التجربة الكاملة.
الخطوة 1: شغّل النص أولاً
قبل الغوص في الصوت، تأكد من أن الأساسيات تعمل:
hermes
ثم اسأل شيئاً بسيطاً:
What tools do you have available?
إذا كان ذلك يعمل بشكل جيد، فأنت جاهز للصوت!
الخطوة 2: تثبيت الحزم الإضافية
اعتماداً على ما تحتاجه، قم بتثبيت الحزم المناسبة:
# CLI microphone + playback
cd ~/.hermes/hermes-agent && uv pip install -e ".[voice]"
# Messaging platforms (Telegram/Discord)
cd ~/.hermes/hermes-agent && uv pip install -e ".[messaging]"
# Premium ElevenLabs TTS
cd ~/.hermes/hermes-agent && uv pip install -e ".[tts-premium]"
# Everything
cd ~/.hermes/hermes-agent && uv pip install -e ".[all]"
الخطوة 3: الاعتماديات النظامية
macOS:
brew install portaudio ffmpeg opus
brew install espeak-ng
Ubuntu/Debian:
sudo apt install portaudio19-dev ffmpeg libopus0
sudo apt install espeak-ng
إليك سبب أهمية هذه الحزم:
portaudio← إدخال الميكروفون للصوت في CLIffmpeg← تحويل الصوتopus← ترميز صوت Discordespeak-ng← مُنظّم الأصوات لـ NeuTTS
الخطوة 4: اختر مزوّديك
أسهل إعداد: استخدم التعرف المحلي على الكلام و Edge TTS المجاني. أضف هذا إلى ~/.hermes/.env:
# Cloud STT options (local needs no key)
GROQ_API_KEY=***
VOICE_TOOLS_OPENAI_KEY=***
# Premium TTS (optional)
ELEVENLABS_API_KEY=***
خيارات التعرف على الكلام (STT):
local– الأفضل للخصوصية، بدون تكلفةgroq– نسخ سحابي فائق السرعةopenai– خيار مدفوع جيد كاحتياطي
خيارات تحويل النص إلى كلام (TTS):
edge– مجاني وجيد بما يكفي لمعظم الاستخداماتneutts– محلي/على الجهاز مجانيelevenlabs– أفضل جودةopenai– حل وسط جيدmistral– متعدد اللغات، Opus أصلي
الخطوة 5: الإعداد الموصى به
إليك إعداد افتراضي متين لمعظم الأشخاص:
voice:
record_key: "ctrl+b"
submit_mode: "direct" # TUI: direct | draft
max_recording_seconds: 120
auto_tts: false
beep_enabled: true
silence_threshold: 200
silence_duration: 3.0
stt:
provider: "local"
local:
model: "base"
tts:
provider: "edge"
edge:
voice: "en-US-AriaNeural"
ملاحظة حول submit_mode:
direct(الافتراضي) – يرسل النص المنسوخ فوراًdraft– يضع النص المنسوخ في المحرر لتتمكن من تعديله قبل الإرسال
للحصول على مسودات قابلة للتعديل، اضبط submit_mode: "draft".
استخدام الصوت في CLI
شغّل Hermes وفعّل الصوت:
hermes
ثم اكتب:
/voice on
خطوات التسجيل:
- اضغط
Ctrl+B - تحدث
- انتظر حتى يتوقف التسجيل تلقائياً عند اكتشاف الصمت
- يقوم Hermes بنسخ كلامك والرد
- إذا كان TTS مفعلاً، سيتحدث بالإجابة
- تتكرر الحلقة للاستخدام المستمر
أوامر مفيدة:
/voice
/voice on
/voice off
/voice tts
/voice status
سير عمل صوتي رائع
تصحيح الأخطاء أثناء التنقل: قل “أستمر في الحصول على خطأ صلاحيات docker. ساعدني في تصحيحه.” ثم تابع بدون استخدام اليدين: “اقرأ الخطأ الأخير مرة أخرى”، “اشرح السبب الجذري بعبارات أبسط”، “الآن أعطني الإصلاح الدقيق”.
البحث/العصف الذهني: مثالي للتجول، وإملاء أفكار نصف مكتملة، وطلب تنظيم أفكارك في الوقت الفعلي من Hermes.
إمكانية الوصول: إذا كانت الكتابة غير مريحة، فإن وضع الصوت يبقيك في حلقة Hermes الكاملة.
ضبط السلوك
إذا كان Hermes يبدأ/يتوقف بشكل عدواني جداً، اضبط إعدادات الصمت في ملف الإعدادات:
voice:
silence_threshold: 200
silence_duration: 3.0
اخفض العتبة لاكتشاف أكثر حساسية، أو ارفعها إذا كان يقطع كلامك.
هذا كل شيء! وضع الصوت هو أحد تلك الميزات التي تشعر وكأنها سحر بمجرد تشغيلها. ابدأ ببساطة، واعتد على الأمر، وقريباً ستجري محادثات كاملة مع Hermes أثناء غسل الأطباق. حديث سعيد! 🎤
📖 التوثيق الرسمي
この記事は Hermes Agent のالتوثيق الرسميに基づいています:التوثيق الرسمي › guides/use-voice-mode-with-hermes