---
id: neonize
version: "0.4.3.post0"
license: unclear
license_treatment: unclear
maintenance: active
---

# neonize — Neonize is a Python library designed to streamline the automation of tasks on WhatsApp

License: unclear · Maintenance: active · Downloads: 85.3K/mo

## What it is and what it does

Neonize wraps the Whatsmeow Go library to provide Python developers with a high-level interface for automating WhatsApp tasks. It handles message sending and receiving, media uploads, group operations, contact management, and real-time event handling through an event-driven architecture. The library supports both synchronous and asynchronous APIs, letting you build bots or integrations that respond to incoming messages, track delivery status, monitor typing indicators, and manage group membership.

The package depends on ten runtime libraries including httpx, pillow, protobuf, requests, and others for HTTP communication, image processing, serialization, and utility functions. It requires Python 3.10 or higher and is actively maintained with recent commits. No known security vulnerabilities are recorded, though the license status remains unclear in the package metadata.

Use it for:

- Build a WhatsApp bot that auto-replies to specific keywords or commands in direct messages or groups.
- Automate sending bulk notifications, alerts, or scheduled messages to WhatsApp contacts or group chats.
- Create a group management tool that adds, removes, or updates group members and settings programmatically.
- Integrate WhatsApp messaging into an existing Python application for two-way communication with users.
- Monitor and log incoming messages and events from WhatsApp for analytics or compliance purposes.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Neonize is a Python library for automating WhatsApp messaging and group management tasks, built on the Whatsmeow Go library with support for text, media, events, and real-time async operations.

Yes, with conditions. Neonize is actively maintained, has low install friction, and offers a straightforward API for WhatsApp automation. However, verify the license terms in the repository before production use, since the package metadata does not declare a license. Also confirm that the Go backend dependency is compatible with your deployment environment. If you need WhatsApp automation in Python and can resolve the license question, this is a solid choice.

## Install

pip install neonize
uv add neonize
poetry add neonize

## Installing neonize

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with recent commits and steady development; 718 repository stars indicate community adoption. Ten runtime dependencies (httpx, pillow, protobuf, requests, etc.) are all widely-used libraries with stable track records.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms in the repository before use in commercial or restricted contexts.

Quickstart:

pip install neonize

from neonize.client import NewClient
from neonize.events import MessageEv, ConnectedEv, event

client = NewClient("my_bot")

@client.event(MessageEv)
def on_message(client: NewClient, event: MessageEv):
    if event.message.conversation == "hi":
        client.reply_message("Hello!", event.message)

client.connect()
event.wait()

Requires Python 3.10 or higher. The async API uses asyncio.run() as the standard entry point and will raise errors on Python 3.12+ if the deprecated asyncio.get_event_loop() pattern is used instead.

Verify before relying:

- Whether the Go backend (Whatsmeow) is bundled or requires separate installation.
- Specific WhatsApp API rate limits or account restrictions that may apply.
- Database support details for SQLite and PostgreSQL mentioned in the description.
- Whether end-to-end encryption is handled transparently or requires explicit setup.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 85.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

whatsapp automation python, whatsapp bot library, whatsapp message api, whatsapp group management, whatsapp client python, whatsapp messaging automation, whatsapp event handling, whatsapp-automation, messaging-api, event-driven

[View on SkillFed](https://skillfed.io/packages/neonize) · [View on PyPI](https://pypi.org/project/neonize/)