{"id":15790152,"url":"https://github.com/pycomet-zz/growth-bot","last_synced_at":"2025-08-24T04:05:06.923Z","repository":{"id":104239333,"uuid":"312714559","full_name":"Pycomet-zz/growth-bot","owner":"Pycomet-zz","description":"This is a telegram bot built to accommodate session strings and use them to add new members into a target group ","archived":false,"fork":false,"pushed_at":"2022-10-25T16:25:18.000Z","size":32,"stargazers_count":3,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T10:28:12.333Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Pycomet-zz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"publiccode":null,"codemeta":null}},"created_at":"2020-11-14T00:30:27.000Z","updated_at":"2024-08-21T18:06:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"a0904dab-b28f-4c70-bdce-0b283c9c49a8","html_url":"https://github.com/Pycomet-zz/growth-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Pycomet-zz/growth-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pycomet-zz%2Fgrowth-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pycomet-zz%2Fgrowth-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pycomet-zz%2Fgrowth-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pycomet-zz%2Fgrowth-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pycomet-zz","download_url":"https://codeload.github.com/Pycomet-zz/growth-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pycomet-zz%2Fgrowth-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265829182,"owners_count":23835090,"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-10-04T22:05:08.538Z","updated_at":"2025-07-18T20:36:45.853Z","avatar_url":"https://github.com/Pycomet-zz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003c!-- \u003ca href=\"https://github.com/Pycomet/telegram-group-engagement-bot\"\u003e\n    \u003cimg src=\"images/logo.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e --\u003e\n\n  \u003ch3 align=\"center\"\u003eTelegram Growth Bot\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    The primary function of this bot is to grow telegram groups to unbelievably huge number of members.\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/Pycomet/growth-bot\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/Pycomet/growth-bot\"\u003eView Demo\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/Pycomet/growth-bot/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/Pycomet/growth-bot/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n### About The Project\n\nThis is a custom built telegram bot script application to add users embedded in a User Friendly process oriented bot to handle the onbarding and smooth flow of the service provided. Which is extracting users from specified target groups and adding them into the user's own group.\n\n### Here are the processes followed\n\nAfter initiating the `/start` command;\n\n1.  The bot requests for the group you would like to extract members from ? (it has to be a group with members and not a channel with subscribers)\n\n2.  The bot requests for an index point to start the adding process from. This basically helps you start off from where you left off the previous day after extract from the group used in `step 1`.\n\nNOW IS THE BOT'S TURN 🤓\n\n1.  Th first thing the bot does is fetch all the client sessions it has access to as preconfigured. All into a list.\n\n2.  Using each of the sessions, one at a time. The bot used the client user to add the extracted user into the target group with a maximum of 50 on each client (Maximum number of adds per day).\n\nThe index is always registered to the runtime memory, so whichever the client that is used. The application is not going over the same users twice.\n\n... And after all is done, the bot signifies, the number of users added, the number of failed attempts and finally says bye, hoping to see you in around 24hours.\n\n### Built With\n\nThis application is built with python entirely. With functionalities pulled from the telethon and PyTelegramBotAPI libraries.\n\n\u003c!-- USAGE EXAMPLES --\u003e\n\n### Usage\n\nTo use this application as your own, follow these simple steps;\n\n- Fork this repository (`git clone https://github.com/Pycomet/growth-bot.git`)\n\n- Create a `.env` file with the following data\n\n  - `TOKEN` - This is the telegram bot token from `@botfather`\n  - `GROUP` - The target telegram group you wish to grow\n  - `API_ID` - Telegram api access details\n  - `API_HASH` - Telegram api access details\n  - `SERVER_URL` - Pre-defined web hook to be used for the app\n  - `ADMIN1` - Admin telegram ID for special access\n\n- Goto `config.py` and set `DEBUG` to \"True\" to run locally and \"False\" to run in production (With involves following the deployment process)\n\n- Run the entrypoint file `python bot.py`\n\nEnjoy!\n\n## Show your support\n\nGive a ⭐️ if this project helped you!\n\n\u003c!-- ROADMAP --\u003e\n\n### Roadmap\n\nSee the [open issues](https://github.com/Pycomet/growth-bot/issues) for a list of proposed features (and known issues).\n\n\u003c!-- CONTRIBUTING --\u003e\n\n### Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003c!-- LICENSE --\u003e\n\n### License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n\u003c!-- CONTACT --\u003e\n\n### Contact\n\nCodefred - \u003ca href=\"https://www.codefred.me\"\u003ewww.codefred.me\u003c/a\u003e\n\nenv -\u003e (growthbotenv)\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/Pycomet/growth-bot.svg?style=flat-square\n[contributors-url]: https://github.com/Pycomet/growth-bot/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/Pycomet/growth-bot.svg?style=flat-square\n[forks-url]: https://github.com/Pycomet/growth-bot/network/members\n[stars-shield]: https://img.shields.io/github/stars/Pycomet/growth-bot.svg?style=flat-square\n[stars-url]: https://github.com/Pycomet/growth-bot/stargazers\n[issues-shield]: https://img.shields.io/github/issues/Pycomet/growth-bot.svg?style=flat-square\n[issues-url]: https://github.com/Pycomet/growth-bot/issues\n[license-shield]: https://img.shields.io/github/license/Pycomet/growth-bot.svg?style=flat-square\n[license-url]: https://github.com/Pycomet/growth-bot/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/alfredemmanuelinyang/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpycomet-zz%2Fgrowth-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpycomet-zz%2Fgrowth-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpycomet-zz%2Fgrowth-bot/lists"}