Installation

Requirements

  • Python 3.8 or higher

  • pip or uv package manager

Install from PyPI

The easiest way to install the WhatsApp SDK is from PyPI:

pip install whatsapp-sdk

Or using uv:

uv add whatsapp-sdk

Install from Source

To install the latest development version from GitHub:

pip install git+https://github.com/alejandrovelez243/whatsapp-sdk.git

Or clone and install locally:

git clone https://github.com/alejandrovelez243/whatsapp-sdk.git
cd whatsapp-sdk
pip install -e .

Development Installation

For development with all testing and linting tools:

git clone https://github.com/alejandrovelez243/whatsapp-sdk.git
cd whatsapp-sdk

# Using uv (recommended)
uv sync --extra dev

# Or using pip
pip install -e ".[dev]"

Dependencies

The SDK has minimal dependencies:

  • httpx: Modern HTTP client with connection pooling

  • pydantic>=2.0: Data validation and type safety

  • python-dotenv: Environment variable management (optional)

All dependencies are automatically installed when you install the SDK.

Verify Installation

To verify the installation:

import whatsapp_sdk
print(whatsapp_sdk.__version__)

Or from the command line:

python -c "import whatsapp_sdk; print(whatsapp_sdk.__version__)"

Next Steps

Once installed, proceed to Quick Start to learn how to use the SDK.