TG-UserBot

A modular Telegram UserBot for Python which uses the Telethon library. It is made to help you do your usual client tasks without the hassle and also has some additional useful features.

Deploy to Heroku Directly

• Go to https://redislabs.com/ and make a free 30 MB database and copy it's endpoint and password.
• Clone the repository and install the requirements. Read the procedure section below.
• Add your API keys and Redis endpoint and password in your config's telethon section.
• Run the bot, login once till the bot running. Finally, exit the script with Ctrl + C and use the button below to deploy.
• If the deploy button doesn't work for you, use this template link.

Incase your session becomes invalid, just run the bot locally again, it will delete your old session from Redis. Then run it again, login and exit it and restart your dyno on Heroku.

Requirements

• Python 3.7.3 or above.
• A Telegram API key (API ID and hash).

Procedure

Clone the repository.

$ git clone https://github.com/kandnub/TG-UserBot/

Change the current directory to the cloned one.

$ cd TG-UserBot

Edit the sample_config.ini with your API key, save it and rename it to config.ini. You can use nano/vim or do it manually using a text editor.

$ nano sample_config.ini
$ mv sample_config.ini config.ini

Install all the requirements using pip.

$ pip3 install --user -r requirements.txt

Run the UserBot once you have a valid configuration file.

$ python3 -m userbot

Resources

• View the TG-UserBot documentation if you're stuck somewhere or need to find something.
• Join the Telegram support group if you have any issues or feedback that you'd like to share.

Contributing

Either submit pull requests or create an issue on here, if not, you can join the support group and let us know. Module/command requests or ways to improve the current code is also appreciated.

Copyright & License

• Copyright (C) 2019 Kandarp <https://github.com/kandnub>
• Licensed under the terms of the GNU General Public License v3.0 or later (GPLv3+)