---
id: wled
version: "0.23.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# wled — Asynchronous Python client for WLED.

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

## What it is and what it does

wled is an asynchronous Python client for controlling WLED devices—programmable LED strips that expose a network API. It wraps HTTP communication with aiohttp and handles serialization via mastering and orjson, allowing you to query device state, adjust brightness and color, toggle effects, and manage segments from Python code. The library is designed for integration into home automation systems and third-party applications that need to automate LED behavior without blocking the event loop.

The package targets modern Python (3.11–3.14) and is actively maintained with a permissive MIT license. It depends on standard async ecosystem libraries (aiohttp, yarl, awesomeversion, python-backoff, mashumaro) and installs as a pure wheel with no compiled dependencies, making it straightforward to add to existing projects.

Use it for:

- Integrate WLED strips into a Home Assistant automation or custom home automation system.
- Build a Python script to synchronize LED colors with music, time of day, or external events.
- Monitor and control multiple WLED devices programmatically from a central application.
- Automate LED brightness and effects based on sensor input or scheduled tasks.
- Develop a web dashboard or CLI tool that communicates with WLED devices over the network.

## Worth the install?

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

An asynchronous Python client library for controlling and monitoring WLED devices over the network, enabling programmatic automation of LED strip behavior.

Yes. The package is actively maintained, carries no known vulnerabilities, installs with low friction, and provides a clean async API for a well-defined task. Install it if you need to control WLED devices from Python; skip it if you have no WLED hardware or prefer synchronous code.

## Install

pip install wled
uv add wled
poetry add wled

## Installing wled

Before you install: Low friction install with a pure-Python wheel distribution. The package is actively maintained with recent releases and carries no known vulnerabilities. Dependencies are all stable, widely-used async and serialization libraries.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both personal and commercial projects.

Quickstart:

pip install wled

import asyncio
from wled import WLED

async def main():
    async with WLED("wled-frenck.local") as led:
        device = await led.update()
        await led.master(on=True, brightness=255)

asyncio.run(main())

Requires Python 3.11 or later; the WLED device must be reachable on the network.

Verify before relying:

- Whether the package supports all WLED firmware versions or only recent ones.
- Whether network discovery or device auto-detection is available beyond direct hostname/IP.
- Specific rate limits or throttling behavior when controlling multiple segments or effects.

## Package facts

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

## Tags

wled api client python, async led control library, wled device automation, python wled integration, smart led strip control, home automation led client, wled network control, async-io, home-automation, led-control

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