A small python framework to create a whatsapp bot, with regex-callback message routing.
Python Shell
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 3 commits behind joaoricardo000:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
opt
src
.gitignore
Dockerfile
README.md

README.md

whatsapp-bot-seed

A small python seed to create a Whatsapp Bot, with regex-callback routes (just like a web framework).
(practical extension of the examples on https://github.com/tgalal/yowsup)

What it does?

  • Basic message handling:
    Example

  • Automatic media (images and videos) download, and url print screens
    Example

  • Youtube Video Downloads, and Text to Speech
    Example

  • Google image and web search
    Example

  • Group administration
    Example
    and a bit more...

Installation

  1. Install the image handling system dependencies on bash opt/system-requirements.sh
  2. Create a virtualenv and install the requirements pip install -r opt/requirements.pip
  3. Follow the instructions on src/config.py to get the whatsapp credentials.
  4. Then just run the server with python src/server.py

Or with Docker!

$ git clone https://github.com/joaoricardo000/whatsapp-bot-seed/
$ cd whatsapp-bot-seed
(Edit Dockerfile to include your credentials)
$ docker build -t whatsapp-bot .
$ docker run -p 0.0.0.0:9005:9005 whatsapp-bot

The server will be running. Access http://localhost:9005 (default: admin:password) for process controll and logs.

To create your own views, check out src/router.py and src/view/basic_views.py for examples.