telegram chat summarizer

Aplikasi Peringkas Obrolan Telegram

Apakah Anda bosan membaca banyak pesan Telegram setiap hari untuk mencari informasi berharga? Keselamatan ada di sini!

Repositori ini menampung implementasi aplikasi Telegram yang memantau dan merangkum obrolan grup. Awalnya dibuat untuk penggunaan pribadi, ini ditujukan untuk orang-orang yang perlu mengumpulkan informasi dari satu atau beberapa obrolan grup Telegram besar-besaran yang menghasilkan terlalu banyak pesan untuk ditinjau secara manual.

Berdasarkan konfigurasi yang diberikan:

1. Pantau serangkaian obrolan grup Telegram tertentu menggunakan API Telegram.
2. Meringkas obrolan yang dipantau selama periode lihat balik yang ditentukan (yaitu jika Anda menetapkan periode lihat balik menjadi 12 jam, Anda akan menerima ringkasan selama 12 jam terakhir dua kali sehari). Hanya pesan teks yang dianalisis saat ini.
3. Mengirimkan ringkasan ke sekelompok pengguna Telegram tertentu menggunakan Bot API.
4. Untuk setiap ringkasan yang dikirim, aplikasi mempertahankan konteks ringkasan hingga ringkasan berikutnya sehingga pengguna dapat mengajukan pertanyaan klarifikasi pada ringkasan tersebut.

Instalasi

1. Dapatkan nilai api_id dan api_hash untuk API Telegram menggunakan panduan ini.
2. Buat bot Telegram dan dapatkan tokennya menggunakan panduan ini.
3. Dapatkan kunci API OpenAI dari sini. Untuk saat ini aplikasi memiliki backend OpenAI yang dikodekan dengan keras (model gpt-4-turbo-preview ), tetapi cukup mudah untuk menggantinya dengan backend pilihan Anda karena digunakan melalui panggilan perpustakaan LangChain.
4. Tulis perintah untuk ringkasan obrolan. Gunakan yang ada di folder examples/ sebagai referensi.
5. Tentukan konfigurasi dan simpan ke file 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. Instal persyaratan Python yang ditentukan dalam file require.txt atau buat image Docker:

python3 -m pip install -r requirements.txt

atau

docker build -t tcsa:latest .

6. Jalankan aplikasi:

python3 app.py config.json

atau

docker run -it tcsa:latest

Saat pertama kali dijalankan, aplikasi akan meminta Anda untuk masuk ke akun Telegram yang digunakan, seperti ini:

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:

Kemudian sesi tersebut akan disimpan di disk, dan proses berikutnya tidak memerlukan autentikasi.

Penggunaan

Setelah aplikasi aktif dan berjalan, setiap pelanggan ringkasan perlu mengirim pesan /verify ke bot agar dapat mendaftarkan pengguna.

Bot dapat mengganti konteks percakapan dengan diberikan perintah /<summarized chat name> (nama obrolan dapat berupa apa saja yang ditentukan dalam konfigurasi). Mekanisme ini digunakan jika Anda memiliki lebih dari satu obrolan yang diringkas: dengan memberikan perintah yang sesuai, Anda dapat mengalihkan konteks LLM ke obrolan lain dan mendiskusikan ringkasan obrolan tersebut.

Detail dan batasan implementasi

Penerapannya sangat sederhana, dan pasti ada ruang untuk perbaikan. Beberapa barang bagus untuk dimiliki (PR dipersilakan!):

1. Persistensi penyimpanan disk untuk verifikasi pengguna dan konteks obrolan.
2. Menyingkirkan mekanisme berlangganan ringkasan demi sesuatu yang tidak terlalu merepotkan.
3. Manajemen aplikasi dasar (obrolan untuk diringkas, ringkasan pelanggan, dll.) melalui bot sebagai alternatif dari file konfigurasi.
4. Pesan pendukung selain pesan teks: pesan suara, gambar, video.

Ada panduan langkah demi langkah tentang Habr (RU) yang ditulis setelah implementasi ini.