GTTS

الجوزاء النص إلى الكلام

تحويل المحتوى المكتوب إلى خطاب باستخدام Google AI (Gemini) لتوليد النصوص واسترجاع المعلومات المستندة إلى الإنترنت.

---

جدول المحتويات

1. كيف تعمل
2. ملاحظة المشروع
3. تثبيت المشروع
4. أمثلة المشروع
5. المساهمين

---

❓ كيف يعمل

يعتمد هذا المشروع على مثال في اختبار/app.ts. ينفذ الخطوات التالية:

1. يجلب إدخال صوت
2. يرسل طلبًا إلى واجهة برمجة تطبيقات Google Gemini لتلقي استجابة تم إنشاؤها من الذكاء الاصطناعى
3. يقوم بتحويل الاستجابة إلى الكلام تلقائيًا باستخدام تقنية النص إلى الكلام (TTS)
4. يلعب الصوت الذي تم إنشاؤه

---

؟ ملاحظة المشروع

تم اختبار هذا المشروع على Linux (Ubuntu 24.04 LTS X86_64). يمكن لمستخدمي Windows تثبيت Sox عبر SourceForge. المعلومات الخاصة بـ MacOS غير متوفرة حاليًا.

مهمة	أولوية	حالة
تنفيذ دردشة الجوزاء	عالي	✅ الانتهاء
تطوير التعرف على الصوت	عالي	✅ الانتهاء
تنفيذ الكشف عن لغة الصوت	عالي	✅ الانتهاء
تنفيذ الكشف عن اللغة النصية	واسطة	✅ الانتهاء
تنفيذ مشغل صوت	قليل	✅ الانتهاء
تحديد التعداد	قليل	✅ الانتهاء
دمج تصحيح الأخطاء	قليل	✅ الانتهاء

---

؟ تثبيت المشروع

قبل استخدام هذا المستودع ، تأكد من تثبيت التبعيات التالية على نظامك:

Linux

• Sox : sudo apt-get install sox
• libsox-fmt-all : sudo apt-get install libsox-fmt-all
• FFMPEG : sudo apt install ffmpeg

النوافذ

• SOX : قم بتنزيل من SourceForge
• FFMPEG : choco install ffmpeg (باستخدام الشوكولاتة) أو التنزيل من موقع الويب الرسمي

ماكوس

تعليمات التثبيت الخاصة بـ MacOS غير متوفرة في هذا الوقت.

لتثبيت الحزمة ، استخدم أحد الأوامر التالية بناءً على مدير الحزمة المفضل لديك:

 # npm
$ npm install git+https://github.com/Stawa/GTTS.git --legacy-peer-deps
# Bun
$ bun install git+https://github.com/Stawa/GTTS.git --trust

---

؟ أمثلة المشروع

قبل الغوص في الأمثلة ، تأكد من أن لديك مفاتيح API وبيانات الاعتماد التالية:

• مفتاح Google Gemini API ( lib.GoogleGemini )
  • الحصول على من Google Cloud Console
• Tiktok SessionId ( lib.TextToSpeech )
  • استخراج من ملفات تعريف الارتباط Tiktok Browser بعد تسجيل الدخول
• مفتاح واجهة برمجة تطبيقات Google للكلام ( lib.VoiceRecognition.fetchTranscriptGoogle )
  • توليد من بيانات اعتماد Cloud Cloud
• مفتاح API Deepgram ( lib.VoiceRecognition.fetchTranscriptDeepgram )
  • قم بإنشاء حساب واحصل عليه من وحدة التحكم Deepgram
• edenai api key ( lib.SummarizeText )
  • اشترك واسترداد من لوحة معلومات Edenai

تأكد من تخزين مفاتيح واجهة برمجة التطبيقات هذه بشكل آمن وعدم الالتزام بها للتحكم في الإصدار. فكر في استخدام متغيرات البيئة أو نظام إدارة المفاتيح الآمن.

إليك مثال موجز يوضح كيفية إنشاء استجابة باستخدام واجهة برمجة تطبيقات Google Gemini:

 import { GoogleGemini } from "@stawa/gtts" ;
import dotenv from "dotenv" ;
dotenv . config ( ) ;

const gemini = new GoogleGemini ( {
  apiKey : process . env . GEMINI_API_KEY ,
  model : "gemini-1.5-flash" ,
  enableLogging : true ,
} ) ;

async function main ( ) {
  try {
    const question = "When was Facebook launched?" ;
    console . log ( `Question: ${ question } ` ) ;

    const response = await gemini . chat ( question ) ;
    console . log ( `Gemini's response: ${ response } ` ) ;
  } catch ( error ) {
    console . error ( "An error occurred:" , error ) ;
  }
}

main ( ) ;

---

المساهمين

نحن نقدر مساهمات جميع متعاونينا. يساعد جهود كل شخص في جعل هذا المشروع أفضل. شكر خاص لجميع المساهمين الذين ساعدوا في تشكيل هذا المشروع!

---