Public | Automated Build

Last pushed: a year ago
Short Description
Yowsup is a python library that enables you build application which use WhatsApp service.
Full Description

Yowsup 2

<a href="" target="_blank"><img src="" /></a>

Updates (May 22, 2016)

Yowsup v2.5.0 is out, See release notes


Yowsup opened WhatsApp service under platforms!

Yowsup is a python library that enables you build application which use WhatsApp service. Yowsup has been used to create an unofficial WhatsApp client Nokia N9 through the Wazapp project which was in use by 200K + users as well as another fully featured unofficial client for Blackberry 10



  • Requires python2.6+, or python3.0 +
  • Required python packages: python-dateutil,
  • Required python packages for end-to-end encryption: protobuf, pycrypto, python-axolotl-curve25519
  • Required python packages for yowsup-cli: argparse, readline (or pyreadline for windows), pillow (for sending images)

Install using to pull all python dependencies, or using pip:

pip install yowsup2


You can use the CLI without installation using Docker.

docker pull aminadav/yowsup
docker run --ti --rm aminadav/yowsup

Or you can build it yourself, using the Dockerfile:

 docker build . -t yowsup

Using the CLI after Build:

docker --rm run yowsup yowsup-cli registration --help


You need to have installed python headers (from probably python-dev package) and ncurses-dev, then run

python install

Because of a bug with python-dateutil package you might get permission error for some dateutil file called requires.txt when you use yowsup (see this bug report) to fix you'll need to chmod 644 that file.

FreeBSD (*BSD)

You need to have installed: py27-pip-7.1.2(+), py27-sqlite3-2.7.11_7(+), then run

pip install yowsup2


python install

Administrators privileges might be required, if so then run with 'sudo'


  • Install mingw compiler
  • Add mingw to your PATH
  • In PYTHONPATH\Lib\distutils create a file called distutils.cfg and add these lines:
  • Install gcc: mingw-get.exe install gcc
  • Install zlib
  • python install

If pycrypto fails to install with some "chmod error". You can install it separately using something like

or for python3 from:

and then rerun the install command again

Special thanks

Special thanks to:

and everyone else on the WhatsAPI project for their contributions to yowsup and the amazing effort they put into WhatsAPI, the PHP WhatsApp library

Special thanks goes to all other people who use and contribute to the library as well.

Please read this if you'd like to contribute to yowsup 2.0



As of January 1, 2015 yowsup is licensed under the GPLv3+:

Docker Pull Command
Source Repository