pywizlight

What it is and what it does

pywizlight is a Python connector for WiZ smart light bulbs that provides both a programmatic API and a command-line interface for controlling networked lighting devices. It handles device discovery via UDP broadcast, state queries, and commands to adjust brightness, color temperature, RGB colors, and predefined scenes. The library is async-first, designed to work with asyncio for concurrent control of multiple bulbs.

The package wraps the WiZ Light API with higher-level abstractions like PilotBuilder for constructing control commands and bulb type detection for querying device capabilities (supported features, kelvin range, module name). It supports both direct IP-based control and network-wide discovery, making it suitable for home automation integrations and standalone smart-home tooling.

Use it for:

• Integrate WiZ bulbs into a home automation system or dashboard that needs programmatic control.
• Build a CLI tool or script to discover and manage WiZ lights across a home network.
• Automate lighting scenes and color changes based on time of day, events, or sensor input.
• Query bulb capabilities and state to adapt control logic to device features.
• Control multiple bulbs in parallel using asyncio for responsive multi-light orchestration.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python library and CLI tool for discovering and controlling WiZ smart light bulbs over a network, supporting brightness, color, color temperature, scenes, and effects.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and provides a clean async API for a well-defined use case (WiZ bulb control). Install it if you own WiZ bulbs and need programmatic or CLI control; skip it if you have no WiZ devices or prefer a vendor app.

Install

pywizlight on PyPI

pip install pywizlight

uv add pywizlight

poetry add pywizlight

Installing pywizlight

Before you install

Low friction install with a single runtime dependency (click). Actively maintained with a recent release (9 days old) and 547 repository stars. Requires Python >=3.11.

License in practice

MIT license permits commercial and private use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart

pip install pywizlight

import asyncio
from pywizlight import wizlight, PilotBuilder

async def main():
    light = wizlight("192.168.1.27")
    await light.turn_on(PilotBuilder(brightness=255))

asyncio.run(main())

Requires Python >=3.11; WiZ bulbs must be on the same network and reachable by IP address.

Verify before relying

• Whether the library supports all WiZ device models or only specific bulb types.
• Latency and timeout behavior when bulbs are offline or unreachable.
• Whether UDP broadcast discovery works reliably across different network configurations.

Package facts

Evidence: pywizlight-0.6.6-py3-none-any.whl

Tags

More Networking packages