waha-py
Python SDK for WAHA (WhatsApp HTTP API) - auto-generated from OpenAPI spec with full type safety, Pydantic v2 models, and HTTPX-based synchronous & asynchronous clients.
Installation
pip install waha-py
Usage
Synchronous Client
from waha import WahaClient
# Initialize with baseURL and optional API key
client = WahaClient("http://localhost:3000", api_key="your-api-key")
# Access controllers via properties
# Sessions
sessions = client.sessions.list()
# Chatting
message = client.chatting.send_text(
session="default",
payload={
"chatId": "1234567890@c.us",
"text": "Hello from waha-py!",
},
)
# Get QR Code
qr = client.auth.get_qr(session="default", params={"format": "raw"})
# Always close client when done
client.close()
Asynchronous Client
import asyncio
from waha import AsyncWahaClient
async def main():
async_client = AsyncWahaClient("http://localhost:3000", api_key="your-api-key")
# Send message asynchronously
message = await async_client.chatting.a_send_text(
session="default",
payload={
"chatId": "1234567890@c.us",
"text": "Async hello from waha-py!",
},
)
await async_client.close()
asyncio.run(main())
API Controllers
All endpoints are available through client properties:
client.sessions.* # SessionsApi
client.chatting.* # ChattingApi
client.contacts.* # ContactsApi
client.groups.* # GroupsApi
client.auth.* # AuthApi
client.labels.* # LabelsApi
client.presence.* # PresenceApi
client.profile.* # ProfileApi
client.media.* # MediaApi
# ...and more
Pydantic Models
All types are auto-generated from the WAHA OpenAPI specification using Pydantic v2:
from waha.generated.models import SessionInfo, MessageTextRequest, WAMessage
How It Works
This package is automatically kept in sync with WAHA:
- Daily - GitHub Action spins up latest
devlikeapro/wahacontainer - Fetches OpenAPI spec from
/-jsonendpoint - Compares SHA256 hash with committed
openapi.json - If changed - Generates new types + Python clients, bumps version, commits, and pushes tag
- Publishes to PyPI via OIDC trusted publishing
Development
Prerequisites
- Python >= 3.9
- Running WAHA instance (or
openapi.json)
Generate Types & Clients Locally
# Install development dependencies
pip install -e ".[dev]"
# Generate models and clients from openapi.json
python scripts/generate.py
# Run tests
pytest
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
waha_py-2026.7.2.tar.gz
(231.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file waha_py-2026.7.2.tar.gz.
File metadata
- Download URL: waha_py-2026.7.2.tar.gz
- Upload date:
- Size: 231.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
15e18d7603fc6ffd08019727b8294a0c4e13e3171c704873a0c9e264e5d2ed84
|
|
| MD5 |
53818d04bc0a6980f47d0a07fc31fd11
|
|
| BLAKE2b-256 |
668e099c2a0472de79c62cbee7a0c180160db53e14702124d14eafaf6ba6385f
|
Provenance
The following attestation bundles were made for waha_py-2026.7.2.tar.gz:
Publisher:
publish-trusted.yml on muhammedaksam/waha-py
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
waha_py-2026.7.2.tar.gz -
Subject digest:
15e18d7603fc6ffd08019727b8294a0c4e13e3171c704873a0c9e264e5d2ed84 - Sigstore transparency entry: 2328437528
- Sigstore integration time:
-
Permalink:
muhammedaksam/waha-py@994faefd19c575e03e52315d507f5633fba8bf48 -
Branch / Tag:
refs/tags/v2026.7.2 - Owner: https://github.com/muhammedaksam
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-trusted.yml@994faefd19c575e03e52315d507f5633fba8bf48 -
Trigger Event:
push
-
Statement type:
File details
Details for the file waha_py-2026.7.2-py3-none-any.whl.
File metadata
- Download URL: waha_py-2026.7.2-py3-none-any.whl
- Upload date:
- Size: 76.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
679c96a33749a2cd4d07c5521bcaed025649b5413a68b9982dc3174bd1798173
|
|
| MD5 |
f92e9771fbf7090552bbc752b8b6500e
|
|
| BLAKE2b-256 |
cd2d19072b72f0baf8959676b4a4d9cb17fdc2e41d0d0beee34d77ef3d6652a3
|
Provenance
The following attestation bundles were made for waha_py-2026.7.2-py3-none-any.whl:
Publisher:
publish-trusted.yml on muhammedaksam/waha-py
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
waha_py-2026.7.2-py3-none-any.whl -
Subject digest:
679c96a33749a2cd4d07c5521bcaed025649b5413a68b9982dc3174bd1798173 - Sigstore transparency entry: 2328437597
- Sigstore integration time:
-
Permalink:
muhammedaksam/waha-py@994faefd19c575e03e52315d507f5633fba8bf48 -
Branch / Tag:
refs/tags/v2026.7.2 - Owner: https://github.com/muhammedaksam
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-trusted.yml@994faefd19c575e03e52315d507f5633fba8bf48 -
Trigger Event:
push
-
Statement type:
