{"id":26218472,"url":"https://github.com/mastercruelty/telegramchatinsights","last_synced_at":"2026-05-21T12:09:53.050Z","repository":{"id":230979520,"uuid":"779743047","full_name":"MasterCruelty/TelegramChatInsights","owner":"MasterCruelty","description":"A simple userbot to show some data about your chats on Telegram.","archived":false,"fork":false,"pushed_at":"2024-04-13T14:54:47.000Z","size":55,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-14T09:38:43.544Z","etag":null,"topics":["chart","graph","pyrogram","python3","statistics","telegram-api","telegramstat","userbot-telegram"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MasterCruelty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-03-30T16:54:16.000Z","updated_at":"2024-04-20T17:23:17.528Z","dependencies_parsed_at":"2024-04-22T18:46:20.814Z","dependency_job_id":null,"html_url":"https://github.com/MasterCruelty/TelegramChatInsights","commit_stats":null,"previous_names":["mastercruelty/telegramchatinsights"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MasterCruelty/TelegramChatInsights","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterCruelty%2FTelegramChatInsights","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterCruelty%2FTelegramChatInsights/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterCruelty%2FTelegramChatInsights/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterCruelty%2FTelegramChatInsights/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MasterCruelty","download_url":"https://codeload.github.com/MasterCruelty/TelegramChatInsights/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterCruelty%2FTelegramChatInsights/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28029138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-25T02:00:05.988Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chart","graph","pyrogram","python3","statistics","telegram-api","telegramstat","userbot-telegram"],"created_at":"2025-03-12T13:17:11.709Z","updated_at":"2025-12-25T12:18:18.671Z","avatar_url":"https://github.com/MasterCruelty.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![License](https://img.shields.io/github/license/MasterCruelty/telegramchatinsights)\n[![image](https://img.shields.io/github/stars/MasterCruelty/telegramchatinsights)](https://github.com/MasterCruelty/telegramchatinsights/stargazers)\n[![image](https://img.shields.io/github/forks/MasterCruelty/telegramchatinsights)](https://github.com/MasterCruelty/telegramchatinsights/network/members)\n![CodeSize](https://img.shields.io/github/languages/code-size/MasterCruelty/telegramchatinsights)\n[![image](https://img.shields.io/github/issues/MasterCruelty/telegramchatinsights)](https://github.com/MasterCruelty/telegramchatinsights/issues)\n![image](https://img.shields.io/github/languages/top/MasterCruelty/telegramchatinsights)\n![image](https://img.shields.io/github/commit-activity/w/MasterCruelty/telegramchatinsights)\n![image](https://img.shields.io/github/contributors/MasterCruelty/telegramchatinsights)\n\n# Telegram Chat Insights\n\n# What is it\nThis project is about a Telegram app made by creating a userbot based on Pyrogram.\u003cbr\u003e\nThe main feature is to show your data about personal chat by plotting charts. It's still in development and more features could be implemented.\n\n### Contribute\nFeel free to contribute and improve the project. You can read the guidelines to contribute [here](https://github.com/MasterCruelty/TelegramChatInsights/blob/main/CONTRIBUTING.md)\n\n# How to setup\n\nThe correct way to setup this bot is to compile the file  ```config.json```. So it's necessary to have these data:\n\n* Telegram api keys: ```api_id``` e ```api_hash```. You can generate them [here](https://my.telegram.org/apps)\n* Telegram data of the owner of the bot: ```id_super_admin```.\n* The path where is the .db file: ```path_db```.\n* The session name: ```session_name```.\n* Name of super admin commands: ```super_admin_commands```.\n\nName of commands to put inside ```config.json``` can be copied from source code or renamed inside source code and then copied in json file.\t\n\n### How the userbot's commands works\n\nThe features of the commands are explained inside ```help.json```. It is the file which is used by the userbot to reply at ```/help \u003ccommand name\u003e```.\n\n### How the admin/super commands works\n\n* register a new chat: ```/setchat``` \u003cid_user\u003e\n* delete a chat: ```/delchat``` \u003cid_user\u003e\n* How to list all user registered: ```/listchat``` \n* How to show ho many chats are registered: ```/allchat```\n* How to get all saved data about a specific chat: ```/getchatdata``` \u003cid_chat\u003e \n* How to update a record value of a chat: ```/updatechat``` \u003cid_chat\u003e \u003cnew_value\u003e \u003cold_value\u003e\n* check if the bot is online: ```/ping```\n\n### Example of execution\nThis is an example of piechart plotted. It shows the weight of every chat saved.\n![image](https://github.com/MasterCruelty/TelegramChatInsights/assets/72561502/1b833ebb-6a47-4a92-8d25-bb994475348c)\n\n### How data is collected\nThere's a dedicated command to do that: ```/newcheck``` \u003cbr\u003e\nBy launching it, it starts calculating all the amount of messages for every saved chat using Telegram API and save those data with the current date.\u003cbr\u003e\nThe next time you decide to launch this command, you can view the difference between the last check and the new one.\u003cbr\u003e\nAt the moment this command is launched manually by the user, thought initially as userbot not running 24/7.\u003cbr\u003e\nIn the near future it could be instead an automatic check made daily or weekly and then a 24/7 running app.\n\n\n### Dependencies\n\n* Pyrogram\n* peewee\n* tempfile\n* matplotlib\n* numpy\n\n### External projects used\n\n* [Pyrogram](https://github.com/pyrogram/pyrogram)\n* [Peewee](https://github.com/coleifer/peewee)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastercruelty%2Ftelegramchatinsights","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmastercruelty%2Ftelegramchatinsights","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastercruelty%2Ftelegramchatinsights/lists"}