{"id":21395,"library":"govee-api-laggat","title":"Govee API","description":"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.","status":"active","version":"0.2.2","language":"python","source_language":"en","source_url":"https://github.com/LaggAt/python-govee-api","tags":["govee","api","led","smart-home","iot"],"install":[{"cmd":"pip install govee-api-laggat","lang":"bash","label":"pip install"}],"dependencies":[{"reason":"HTTP requests for API calls","package":"requests","optional":false}],"imports":[{"note":"Underscore in package name replaces hyphens; common mistake to use dot or underscore in wrong place.","wrong":"import govee_controller; from govee.api import Govee","symbol":"Govee","correct":"from govee_api_laggat import Govee"}],"quickstart":{"code":"import os\nfrom govee_api_laggat import Govee\n\napi_key = os.environ.get('GOVEE_API_KEY', '')\ngovee = Govee(api_key)\ndevices = govee.get_devices()\nif devices:\n    device = devices[0]\n    govee.turn_on(device)\n    govee.set_brightness(device, 50)\n    govee.set_color(device, 255, 0, 0)  # Red","lang":"python","description":"Initialize Govee API with an API key from environment variable, then list devices and control first one."},"warnings":[{"fix":"Always pass both `device_name` and `device_mac` to control methods, as returned by `get_devices()`.","message":"The 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.","severity":"deprecated","affected_versions":"all"},{"fix":"Add a small delay (e.g., `time.sleep(0.5)`) between commands.","message":"The library uses an undocumented rate limit; sending commands too quickly may result in silent failures.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure RGB values are integers and within 0-255 before calling `set_color`.","message":"The `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.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use `pip install govee-api-laggat` and then `from govee_api_laggat import Govee`.","cause":"Installing `govee-api-laggat` but trying to import with hyphens or wrong underscore pattern.","error":"ImportError: No module named 'govee_api_laggat'"},{"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.","cause":"Invalid API key or missing required device parameters (device_name, device_mac).","error":"requests.exceptions.HTTPError: 400 Client Error: Bad Request"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}