---
id: govee-ble
version: "1.4.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# govee-ble — Manage Govee BLE devices

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

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

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

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

## Tags

govee bluetooth device control, ble smart light management, govee device integration, bluetooth low energy home automation, govee iot device library, iot, bluetooth, home-automation

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