---
id: pywizlight
version: "0.6.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# pywizlight — A python connector for WiZ light bulbs (e.g SLV Play)

License: permissive · Maintenance: active · Downloads: 78.6K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 78.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

wiz smart bulb control, smart light python library, wiz light api connector, network light bulb control, smart home lighting automation, wiz device discovery, rgb color light control, smart-home, iot-control, async-first

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