# tgalal/yowsup

The WhatsApp lib

Repository: https://github.com/tgalal/yowsup
Canonical: https://ross.abutalabs.com/products/yowsup
Language: Python
License: GPL-3.0
License Family: copyleft
Last push: 2024-08-08T20:50:41+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 5051, "days_push": 755, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7172, forks 2179 (observed 2026-08-28T04:09:56.397399+00:00)

## What it is
Yowsup is a Python library that implements the WhatsApp protocol, enabling developers to build custom applications and clients that communicate with WhatsApp users. It originated as the protocol engine behind Wazapp for Meego and OpenWA for BB10.

## Use cases
- send and receive WhatsApp messages from a Python application
- build a custom WhatsApp client
- automate WhatsApp message delivery
- integrate WhatsApp messaging into a bot or service
- experiment with the WhatsApp protocol and its encryption

## When to choose
- you need programmatic access to WhatsApp outside the official Business API
- you want to build a custom WhatsApp client in Python
- you are researching the WhatsApp protocol or its Noise/signal-based encryption

## When to avoid
- you need a supported, ToS-compliant official solution (use the WhatsApp Business API)
- you require modern Python versions (the library targets Python 2.7-3.7)
- you need guaranteed reliability for production messaging, since it is an unofficial reverse-engineered protocol

## Facets
- artifact type: library
- maturity: maintenance
- function: sdk, http-client, cryptography, chatbot
- domain: messaging-platforms, developer-tools, security
- platform: python, windows, cross-platform
- tags: whatsapp, messaging, protocol-implementation, unofficial-api, e2e-encryption, automation, linux, macos

## Member repositories
- tgalal/yowsup (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:56.397399+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:39:56.782521+00:00, confidence not recorded.
  - readme: https://github.com/tgalal/yowsup (fetched 2026-08-28T04:09:56.397399+00:00, sha 10ea8afeb89a)
  - registry_pypi: https://pypi.org/pypi/yowsup/json (fetched 2026-08-29T08:35:07.362794+00:00, sha d1680f3118a6)
- Data as of 2026-08-30T08:39:29.467469+00:00.