---
id: pylutron-caseta
version: "0.29.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pylutron-caseta — Provides an API to the Lutron Smartbridge

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

## What it is and what it does

pylutron-caseta is an async Python client for the Lutron Caséta smart home bridge, enabling programmatic control of Lutron lighting and shading devices over a local network. It handles TLS authentication, device discovery, and state management through a simple API that returns devices as dictionaries and exposes methods like turn_on, turn_off, and set_level.

The package is designed for integration into larger home automation systems and provides both a high-level Smartbridge class for typical use and lower-level pairing and LEAP protocol access for advanced workflows. It depends on cryptography for TLS, orjson for efficient JSON parsing, and async-timeout for connection management, and requires Python 3.10 or later.

Use it for:

- Build a home automation dashboard that reads and controls Lutron lights and dimmers from a central Python application.
- Integrate Lutron Caséta devices into a broader smart home system alongside other IoT platforms via a unified API.
- Create automated lighting scenes triggered by external events (time, presence, weather) by calling bridge control methods.
- Develop a mobile or web app backend that communicates with Lutron devices through a Python service.
- Monitor and log device state changes over time for energy usage analysis or debugging.

## Worth the install?

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

A Python API for controlling Lutron Caséta smart home devices via their bridge, supporting async communication with TLS authentication and device state management.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive license, and installs cleanly with minimal dependencies. It is well-suited for anyone building Python-based home automation or integrating Lutron Caséta devices into a larger system. The main constraint is the requirement to complete a one-time pairing process with the bridge before use.

## Install

pip install pylutron-caseta
uv add pylutron-caseta
poetry add pylutron-caseta

## Installing pylutron-caseta

Before you install: Low install friction with a pure-Python wheel and three lightweight runtime dependencies (async-timeout, cryptography, orjson). Active maintenance with a recent release and ongoing commits.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for integration into larger applications.

Quickstart:

import asyncio
from pylutron_caseta.smartbridge import Smartbridge

async def example():
    bridge = Smartbridge.create_tls(
        "192.168.1.100", "caseta.key", "caseta.crt", "caseta-bridge.crt"
    )
    await bridge.connect()
    device = bridge.get_devices_by_domain("light")[0]
    await bridge.turn_on(device["device_id"])
    await bridge.close()

asyncio.run(example())

Requires Python 3.10 or later; TLS certificate files must be generated via pairing process (lap-pair tool or async_pair function) before connecting to the bridge.

Verify before relying:

- Whether the package supports all Lutron Caséta device types or only a subset of the product line
- Performance characteristics when controlling many devices simultaneously or over high-latency networks
- Whether the cli extras (leap-scan, lap-pair, leap tools) are required for typical use or optional for advanced workflows

## Package facts

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

## Tags

lutron caseta control, smart home lighting api, lutron bridge python, home automation dimmer, lutron device control, caseta smartbridge, home automation lighting, home-automation, iot-control, async-api

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