PySwitchbot

What it is and what it does

pySwitchbot is an async Python library for discovering and controlling Switchbot IoT devices via Bluetooth Low Energy. It handles device discovery, authentication (including encrypted communication for locks), and command execution for devices like smart locks and motorized curtains. The library wraps aiohttp, bleak, bleak-retry-connector, cryptography, and pyOpenSSL in an async-first API suitable for home automation integrations.

The package is in alpha status but actively maintained, with recent releases and steady development. It requires Python 3.11+ and supports Python 3.12, 3.13, and 3.14. Lock control requires retrieving encryption keys from the Switchbot account API (a one-time setup step), while other devices typically work with simpler discovery and command patterns.

Use it for:

• Automate smart lock unlock/lock operations in a home automation system by retrieving encryption keys once and reusing them.
• Discover and control motorized curtains programmatically based on time, sensors, or user input.
• Build a multi-device Switchbot controller that discovers all nearby devices and exposes them to a home automation platform.
• Integrate Switchbot devices into an async Python application without blocking on BLE communication.
• Retrieve device status and data from Switchbot devices on demand.

Worth the install?

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

Async Python library to discover and control Switchbot IoT devices over Bluetooth Low Energy.

Yes, if you own Switchbot devices and want to control them from Python. The library is actively maintained, has low install friction, and uses standard async patterns. It is in alpha status, so expect occasional API changes; check the repository for any breaking changes before upgrading. No known security vulnerabilities as of the latest scan.

Install

pyswitchbot on PyPI

pip install pyswitchbot

uv add pyswitchbot

poetry add pyswitchbot

Installing PySwitchbot

Before you install

Low friction install with a pure-Python wheel. Active maintenance with a recent release (7 days old) and steady commit history. Depends on aiohttp, bleak, bleak-retry-connector, cryptography, and pyOpenSSL—all standard async and security libraries.

License in practice

MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, including in commercial projects.

Quickstart

pip install pyswitchbot

import asyncio
from pyswitchbot.discovery import GetSwitchbotDevices

async def main():
    devices = await GetSwitchbotDevices().discover()
    print(devices)

asyncio.run(main())

Requires Python 3.11 or later; Bluetooth hardware and Switchbot devices in range required to discover and control.

Verify before relying

• Whether all Switchbot device types beyond locks and curtains are supported.
• Whether the library works on all operating systems or has platform-specific limitations.
• Performance and reliability characteristics when controlling multiple devices concurrently.

Package facts

Evidence: pyswitchbot-2.4.1-py3-none-any.whl

Tags

More Python Modules packages