Install & Compatibility
Where this runs
tested against v1.2.9 · 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
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 27.1MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 3.8s · import 0.000s · 29MB
27MB installed
● package 27MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
BaseDaemon
✓ from jeedomdaemon import BaseDaemon
✗ from jeedomdaemon import JeedomDaemon
BaseConfig
✓ from jeedomdaemon import BaseConfig
aio_connector
✓ from jeedomdaemon import aio_connector
Basic daemon subclass and startup.
import asyncio
from jeedomdaemon import JeedomDaemon
class MyDaemon(JeedomDaemon):
async def on_message(self, message):
print('Received:', message)
async def main():
daemon = MyDaemon(
apikey=os.environ.get('JEEDOM_APIKEY', ''),
url=os.environ.get('JEEDOM_URL', 'ws://localhost:8080'),
callback=lambda x: print('Callback:', x)
)
await daemon.start()
if __name__ == '__main__':
asyncio.run(main())
Debug
Known issues
breakingJeedomDaemon now requires an explicit callback parameter in the constructor. In older versions (<1.0.0) the callback was optional. If omitted, the daemon will not process replies and may hang.fixProvide a callback function (e.g., lambda x: None) or implement a proper reply handler.
affects: <1.0.0 vs >=1.0.0
deprecatedThe old import path 'from jeedomdaemon.jeedom_socket import JeedomSocket' is deprecated. All public classes are now exposed at the top-level package.fixUse 'from jeedomdaemon import JeedomSocket' instead.
affects: >=1.2.0
gotchaThe daemon's on_message method must be a coroutine. If you define it as a regular function, the library will not await it and the message will be silently dropped.fixAlways define on_message with 'async def'.
affects: all
Upgrade
Version history
1.2.9latest on PyPI · released Mar 14, 2025
Audit
Dependencies
aiohttprequiredCore dependency for async HTTP/WebSocket communication with Jeedom.