Unoffical WhatsApp Automation Library for Python


Supbot2 is an unofficial WhatsApp automation library written in Python which can be used to create bots. Supbot2 uses Appium to automate WhatsApp application to read the GUI and call respective events, and perform various actions on the GUI.

Supbot API (1.0) was extremely tedious to setup and even more difficult to use. Not only that it required to have a phone and Supbot server connected to the Internet, which made it very unstable and unreliable. Supbot2 tries to fix these issues.

Easy to Use

Supbot is exeremly easy and intuitive to use library. It's API is made of just two types of services: Action and Events, which are basically simple function calls.

Aims for Stability

Supbot aims for developers to just concentrate on building the business logic, and not to worry about how the library works. We want the API work flawlessly.



Installing Appium

You will need to setup Appium and Whatsapp before you start with Supbot

"appPackage": "com.whatsapp",
"deviceName": "",
"platformName": "android",
"noReset": "true",
"appActivity": "com.whatsapp.HomeActivity"

If the whatsapp app opens up in your device automatically, Appium is setup perfectly

Installing Supbot

You will need Python >=3.6 in order to install supbot. Supbot is developed using Python 3.7.1, so its recomended to use that, so that you don't encouter unexpected issues.

Install the supbot package using

pip install supbot

Getting Started

Following code resends the message received from a contact (in just 5 LOC!).
Visit Overview to understand the code.

from supbot import Supbot

def repeat_message(contact_name, message):
    supbot.send_message(contact_name, message)

with Supbot(message_received=repeat_message) as supbot:


Check out the Trello board, to see what I'm working on and whats next.


Distributed under the MIT License. See LICENSE for more information.


If you have any problems or you want to contact me for feature ideas or want to collaborate in development you can contact me on DefineX Community discord server.