Registry / communication / govee-api-laggat

govee-api-laggat

library0.2.2pypypi✓ verified 84d ago

Unofficial Python implementation of the Govee API to control LED strips, bulbs, and other Govee devices. Current version 0.2.2, requires Python >=3.7. The package is maintained on an as-needed basis, with infrequent releases.

communication

pip install govee-api-laggat

github ↗package ↗

INSTALL

IMPORT

SIG · GOVEE-API-LAGGAT

govee-api-laggat

communicationpythonv0.2.2

Install

5.3s avg

Import

534ms

Disk

33MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.2.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.558s · 33.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.3s · import 0.510s · 36MB

33MB installed

● package 33MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Govee

✓ from govee_api_laggat import Govee

✗ import govee_controller; from govee.api import Govee

Underscore in package name replaces hyphens; common mistake to use dot or underscore in wrong place.

Initialize Govee API with an API key from environment variable, then list devices and control first one.

import os from govee_api_laggat import Govee api_key = os.environ.get('GOVEE_API_KEY', '') govee = Govee(api_key) devices = govee.get_devices() if devices: device = devices[0] govee.turn_on(device) govee.set_brightness(device, 50) govee.set_color(device, 255, 0, 0) # Red

Debug

Known issues

deprecatedThe method `get_devices()` returns a list of dicts; device parameters like `device_name` and `device_mac` are required in many methods, but the library does not validate them.

fix

Always pass both `device_name` and `device_mac` to control methods, as returned by `get_devices()`.

affects: all

gotchaThe library uses an undocumented rate limit; sending commands too quickly may result in silent failures.

fix

Add a small delay (e.g., `time.sleep(0.5)`) between commands.

affects: all

gotchaThe `set_color` method expects RGB values as integers (0-255), but does not validate input. Passing floats or out-of-range values causes an unhandled exception.

fix

Ensure RGB values are integers and within 0-255 before calling `set_color`.

affects: all

Errors

Common errors & fixes

ImportError: No module named 'govee_api_laggat'

Installing `govee-api-laggat` but trying to import with hyphens or wrong underscore pattern.

fix

Use `pip install govee-api-laggat` and then `from govee_api_laggat import Govee`.

requests.exceptions.HTTPError: 400 Client Error: Bad Request

Invalid API key or missing required device parameters (device_name, device_mac).

fix

Verify your API key from the Govee app and ensure you pass both `device_name` and `device_mac` from `get_devices()` to control methods.

Upgrade

Version history

0.2.2latest on PyPI · released Apr 5, 2022

Audit

Dependencies

requestsrequiredHTTP requests for API calls

Agent activity

14 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/LaggAt/python-govee-api ↗

packagehttps://pypi.org/project/govee-api-laggat/ ↗