govee-ble

What it is and what it does

govee-ble is a Python library for interacting with Govee BLE smart devices—primarily smart lights and sensors—over Bluetooth Low Energy. It wraps the low-level Bluetooth protocol details and provides a higher-level interface to discover devices, read their state, and send commands. The package depends on home-assistant-bluetooth for BLE scanning and connection management, sensor-state-data for standardized sensor reading abstractions, and cryptography for secure device communication.

The library is designed for integration into home automation systems and IoT applications where you need programmatic control of Govee devices. It's actively maintained, supports modern Python versions (3.10–3.14), and carries no known vulnerabilities. Installation is straightforward—a pure Python wheel with no system library prerequisites.

Use it for:

• Integrate Govee smart lights into a Home Assistant or custom home automation setup.
• Build a Python script to batch-control Govee devices (brightness, color, on/off) from a central controller.
• Monitor Govee sensor devices (temperature, humidity) and log readings to a database or cloud service.
• Develop a mobile or web app backend that discovers and commands Govee devices over BLE.
• Create automation rules that trigger Govee device actions based on time, presence, or other sensors.

Worth the install?

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

Provides Python bindings to discover, connect to, and manage Govee BLE smart devices over Bluetooth Low Energy.

Yes. The package is actively maintained, carries no known vulnerabilities, has low install friction, and is licensed permissively. It's suitable for any Python project needing Govee BLE device control. The main caveat is verifying that your specific Govee device models are supported; the fact sheet does not detail which devices work.

Install

govee-ble on PyPI

pip install govee-ble

uv add govee-ble

poetry add govee-ble

Installing govee-ble

Before you install

Low friction: pure Python wheel with no compiled dependencies. Active maintenance—last commit 2026-08-10, release 52 days ago. Supports Python 3.10 through 3.14.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install govee-ble

from govee_ble import GoveeDevice
import asyncio

async def main():
    # Discover and manage Govee BLE devices
    device = GoveeDevice(...)
    await device.connect()

asyncio.run(main())

Requires Python 3.10 or later. Bluetooth hardware and BLE-capable Govee device(s) must be present and within range.

Verify before relying

• Which specific Govee BLE device models are supported or tested.
• Whether the package handles device pairing or assumes pre-paired devices.
• Real-world range, latency, or reliability characteristics under typical home conditions.

Package facts

Evidence: govee_ble-1.4.0-py3-none-any.whl

Tags

More Libraries packages