telegram chat summarizer

تطبيق تلجرام للدردشة

هل سئمت من تصفح الكثير من رسائل Telegram يوميًا بحثًا عن المعلومات القيمة؟ الخلاص هنا!

يستضيف هذا المستودع تطبيق Telegram الذي يراقب ويلخص الدردشات الجماعية. تم إنشاؤه في البداية للاستخدام الشخصي، وهو مخصص للأشخاص الذين يحتاجون إلى جمع المعلومات من واحدة أو عدة محادثات جماعية مباشرة على Telegram والتي تولد عددًا كبيرًا جدًا من الرسائل التي لا يمكن مراجعتها يدويًا.

بناءً على التكوينات المحددة، فإنه:

1. يراقب مجموعة من محادثات مجموعة Telegram المحددة باستخدام Telegram API.
2. يلخص الدردشات المراقبة خلال فترة المراجعة المحددة (على سبيل المثال، إذا قمت بتعيين فترة المراجعة على 12 ساعة، فستتلقى ملخصات لآخر 12 ساعة مرتين يوميًا). يتم تحليل الرسائل النصية فقط حتى الآن.
3. يرسل الملخصات إلى مجموعة معينة من مستخدمي Telegram باستخدام Bot API.
4. بالنسبة لكل ملخص مرسل، يحتفظ التطبيق بسياق التلخيص حتى التلخيص التالي حتى يتمكن المستخدم من طرح أسئلة توضيحية حول الملخص.

تثبيت

1. احصل على قيم api_id و api_hash لواجهة برمجة تطبيقات Telegram باستخدام هذا الدليل.
2. قم بإنشاء روبوت Telegram واحصل على الرمز المميز الخاص به باستخدام هذا الدليل.
3. احصل على مفتاح OpenAI API من هنا. في الوقت الحالي، يحتوي التطبيق على واجهة OpenAI مشفرة بشكل ثابت (نموذج gpt-4-turbo-preview )، ولكن من السهل جدًا استبدالها بالواجهة الخلفية التي تختارها حيث يتم استخدامها عبر مكالمات مكتبة LangChain.
4. اكتب مطالبة لتلخيص الدردشة. استخدم ما هو موجود في examples/ المجلد كمرجع.
5. حدد التكوين واحفظه في ملف config.json :

{
  "telegram_api_id" : <api_id>,
  "telegram_api_hash" : " <api_hash> " ,
  "openai_api_key" : " <key> " ,
  "telegram_bot_auth_token" : " <token> " ,
  "chats_to_summarize" : [
    {
      "id" : " <group chat ID or name> " ,
      "lookback_period_seconds" : 86400 ,
      "summarization_prompt_path" : " prompts/example_summarization_prompt.txt "
    }
  ],
  "telegram_summary_receivers" : [
    " <Telegram username> "
  ]
}

5. قم بتثبيت متطلبات Python المحددة في ملف require.txt أو أنشئ صورة Docker:

python3 -m pip install -r requirements.txt

أو

docker build -t tcsa:latest .

6. تشغيل التطبيق:

python3 app.py config.json

أو

docker run -it tcsa:latest

عند التشغيل لأول مرة، سيطلب منك التطبيق تسجيل الدخول إلى حساب Telegram المستخدم، مثل هذا:

user@pc: ~ /telegram-chat-summarizer $ python3 app.py config.json
2024-03-27 23:03:11,618 - INFO - Started !
Please enter your phone (or bot token): < phone number >
Please enter the code you received: < OTP >
Please enter your password:

سيتم بعد ذلك تخزين الجلسة على القرص، ولن تتطلب عمليات التشغيل اللاحقة المصادقة.

الاستخدام

بمجرد تشغيل التطبيق، يحتاج كل مشترك ملخص إلى إرسال رسالة /verify إلى الروبوت حتى يتمكن من تسجيل المستخدم.

يمكن للروبوت تبديل سياق المحادثة من خلال تزويده بالأمر /<summarized chat name> (يمكن أن يكون اسم الدردشة أيًا من الأسماء المحددة في التكوين). يتم استخدام هذه الآلية إذا كان لديك أكثر من محادثة يتم تلخيصها: من خلال إعطاء الأمر المقابل، يمكنك تبديل سياق LLM إلى دردشة مختلفة ومناقشة ملخص تلك الدردشة.

تفاصيل التنفيذ والقيود

التنفيذ بسيط للغاية، وهناك بالتأكيد مجال للتحسين. بعض الأشياء اللطيفة المباشرة (نرحب بالعلاقات العامة!):

1. استمرارية تخزين القرص للتحقق من المستخدم وسياقات الدردشة.
2. التخلص من آلية الاشتراك الموجز لصالح شيء أقل إزعاجًا.
3. إدارة التطبيق الأساسية (المحادثات التي سيتم تلخيصها، ملخص المشتركين وما إلى ذلك) من خلال الروبوت كبديل لملف التكوين.
4. دعم الرسائل بخلاف الرسائل النصية: الرسائل الصوتية، الصور، مقاطع الفيديو.

يوجد دليل خطوة بخطوة حول Habr (RU) مكتوب بعد هذا التنفيذ.