Naive framework to create your telegram user-bot easily

How to create your userbot

Easy. Just create modules/mod_your_toy.py and enjoy:

def handle_msg_txt(tg, chat_id, sender_id, msg_id, is_outgoing, message_text):
    print(f"[example_mod] handle_msg_txt: chat={chat_id} sender={sender_id} msg={msg_id} is_outgoing={is_outgoing} text={message_text!r}")
    if not is_outgoing:
        tg.send_message(chat_id=chat_id, text="Hey I just got your message!")
    return False

For more details, refer to our doc modules/mod_example.py and examples ./mod_examples.

How to install and run

You need a device with python3 and python-telegram. For example, if you are using Ubuntu Linux:

sudo apt install python3 python3-pip
sudo pip3 install python-telegram

Then download this repo. Modify main.py for config, and install desired mod. Refer to Telegram Official Document about how to get api_id and api_hash.

TELEGRAM_API_ID = 'Change This!'
TELEGRAM_API_HASH = 'Change This!'
TELEGRAM_PHONE = 'Phone number of your telegram account'

Enjoy. Note that first login requires SMS.