Pure-Python port of Baileys — a WhatsApp Web protocol client. No Node.js / node_modules dependency: all crypto is pure Python.
- WhatsApp Web protocol over WebSockets (Noise-encrypted)
- E2EE (Signal) sessions in pure Python
- Pairing code & QR login
- Messages: text, media, contacts, location, react, poll, events, and more
- Interactive messages (buttons, lists, templates) via raw protobuf
- Session persistence with a pluggable key store
- Fully typed generated protobuf classes (no
google.protobufdependency) - Message retry manager for undelivered messages
pip install waeysRequires Python 3.10+. Only runtime dependency: websockets>=12.0.
Complete guides (very detailed, in three languages):
| Language | Guide |
|---|---|
| English | docs/usage.en.md |
| Español | docs/usage.es.md |
| Português | docs/usage.pt.md |
import asyncio
from WAeys.Defaults.index import default_connection_config
from WAeys.Utils.auth_utils import init_auth_creds
from WAeys.Utils.browser_utils import Browsers
from WAeys.Socket.socket import make_socket
async def main():
config = default_connection_config()
config['auth'] = {'creds': init_auth_creds(), 'keys': make_file_key_store()}
config['browser'] = Browsers.macOS('Safari')
config['logger'].level = 'info'
sock = make_socket(config)
ev = sock['ev']
async def on_conn(update):
if update.get('qr'):
print('Scan the QR in WhatsApp > Linked Devices')
print(update['qr'])
if update.get('connection') == 'open':
await sock['sendMessage']('51921826291@s.whatsapp.net', {'text': 'Hello from WAeys!'})
ev.on('connection.update', lambda u: asyncio.ensure_future(on_conn(u)))
await asyncio.Event().wait()
if __name__ == '__main__':
asyncio.run(main())See the full guides above for pairing codes, session persistence, media, interactive messages, events and production tips.
WAeys is pure Python and runs on Linux, macOS, Windows, Android (Termux), Docker, VPS and Raspberry Pi.
This is an unofficial client for the WhatsApp Web protocol. Using it may violate WhatsApp's Terms of Service and can lead to account bans. Use at your own risk. This project is not affiliated with WhatsApp or Meta.
MIT