{"id":23383331,"url":"https://github.com/CyberScoper/stressertelegram","last_synced_at":"2025-08-24T04:31:02.667Z","repository":{"id":258421648,"uuid":"873897236","full_name":"CyberScopeToday/stressertelegram","owner":"CyberScopeToday","description":"A Python-based stress testing tool that interacts with Telegram bots. This project allows users to send a large number of requests to a specified Telegram bot to test its resilience and performance under high load.","archived":false,"fork":false,"pushed_at":"2024-11-30T14:45:36.000Z","size":8,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-30T15:35:09.328Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CyberScopeToday.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"publiccode":null,"codemeta":null}},"created_at":"2024-10-16T23:00:49.000Z","updated_at":"2024-11-30T14:45:40.000Z","dependencies_parsed_at":"2024-11-30T15:38:27.039Z","dependency_job_id":null,"html_url":"https://github.com/CyberScopeToday/stressertelegram","commit_stats":null,"previous_names":["cyberscopetoday/stressertelegram"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Fstressertelegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Fstressertelegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Fstressertelegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Fstressertelegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CyberScopeToday","download_url":"https://codeload.github.com/CyberScopeToday/stressertelegram/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230773595,"owners_count":18278127,"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","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":[],"created_at":"2024-12-21T22:19:53.722Z","updated_at":"2025-08-24T04:31:02.659Z","avatar_url":"https://github.com/CyberScopeToday.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StresserTelegram 🚀\n\n[![CodeFactor](https://www.codefactor.io/repository/github/CyberScoper/stressertelegram/badge)](https://www.codefactor.io/repository/github/CyberScoper/stressertelegram)\n\nA Python-based stress testing tool that interacts with Telegram bots. This project allows users to send a large number of requests to a specified Telegram bot to test its resilience and performance under high load.\n\n## Table of Contents 📑\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [Flood Wait Handling](#flood-wait-handling)\n- [Notes on Usage](#notes-on-usage)\n- [License](#license) \n\n## Introduction 📝\n\nStresserTelegram is a tool designed to help you evaluate how a Telegram bot handles a significant load of incoming requests. The script uses the `telethon` library to communicate with Telegram, enabling it to send multiple messages to a specific bot username. The tool can be useful for performance testing, debugging, and optimizing bot infrastructure.\n\n**Disclaimer**: ⚠️ This tool is meant solely for testing bots you own or have permission to test. Misuse of this tool against bots without proper authorization may lead to legal issues and violate Telegram's terms of service.\n\n## Features ✨\n\n- Allows the user to specify the bot to target via username.\n- Adjustable number of requests to be sent.\n- Handles `FloodWaitError` to prevent violating Telegram's rate limits.\n- Generates \"broken\" random strings to simulate non-standard user input.\n\n## Installation 🛠️\n\nTo use StresserTelegram, you need Python 3.7+ and the following dependencies installed:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/CyberScoper/stressertelegram.git\n   cd stressertelegram\n   ```\n\n2. Install the required Python packages:\n   ```bash\n   pip install telethon\n   ```\n\n## Usage 🚀\n\nBefore using the tool, you need to set up a Telegram API ID and hash, which you can get from [my.telegram.org](https://my.telegram.org).\n\nRun the script using the command line:\n\n```bash\npython bot.py\n```\n\nUpon running the script, you will be prompted for:\n\n- **Bot username** 🤖: Enter the Telegram username of the bot to which you want to send the requests (e.g., `@yourbotname`).\n- **Number of requests** 🔢: Specify the number of requests/messages you want to send.\n\n## Configuration ⚙️\n\n### API Credentials 🔑\n\nUpdate the following values in `bot.py` with your credentials:\n\n- `api_id`: Your Telegram API ID.\n- `api_hash`: Your Telegram API hash.\n- `phone_number`: Your phone number to authenticate with Telegram.\n\n```python\n# Example configuration\napi_id = 1234567\napi_hash = 'your_api_hash_here'\nphone_number = '+1234567890'\n```\n\n### Generating Broken Strings 🔀\n\nThe script generates random strings consisting of alphanumeric characters, punctuation, and whitespace to simulate non-standard user inputs.\n\n## Flood Wait Handling ⏳\n\nIf Telegram detects rapid consecutive messages, it may enforce a \"flood wait\" restriction. In this case, the script will automatically handle the `FloodWaitError` by pausing for the required time (as indicated by the error message). This ensures that you do not violate Telegram's rate limits and avoid temporary bans.\n\n## Notes on Usage 📌\n\n- **Use Responsibly** ⚠️: Only use this tool on bots that you own or manage. Unauthorized testing is strictly forbidden.\n- **Rate Limits** ⏱️: Telegram imposes rate limits on how many messages can be sent within a specific time frame. The tool incorporates a delay to avoid these limits, but it is not foolproof if used irresponsibly.\n- **Ethical Considerations** 🤝: The tool should be used for educational purposes or for improving your bot's performance and resilience. Abusing this tool for malicious purposes is unethical and illegal.\n\n## License 📜\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyberScoper%2Fstressertelegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCyberScoper%2Fstressertelegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyberScoper%2Fstressertelegram/lists"}