{"id":46758,"library":"victron-mqtt","title":"Victron MQTT","description":"Python library for communicating with the MQTT interface of Victron Energy Venus OS devices (e.g., Cerbo GX, Color Control GX). Version 2026.6.3, supports Python >=3.13. Actively maintained, frequent releases.","status":"active","version":"2026.6.3","language":"python","source_language":"en","source_url":"https://github.com/tomer-w/victron_mqtt","tags":["victron","mqtt","venus-os","energy","solar"],"install":[{"cmd":"pip install victron-mqtt","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"MQTT broker communication","package":"paho-mqtt","optional":false},{"reason":"Schema validation for device data","package":"voluptuous","optional":false}],"imports":[{"wrong":"from victron_mqtt import VictronMqttClient","symbol":"Device","correct":"from victron_mqtt import Device"}],"quickstart":{"code":"import os\nfrom victron_mqtt import VictronMqttClient\n\nclient = VictronMqttClient(\n    host=os.environ.get('VICTRON_HOST', 'localhost'),\n    username=os.environ.get('VICTRON_USER', ''),\n    password=os.environ.get('VICTRON_PASSWORD', '')\n)\nclient.start()\n\n# Subscribe to a single device\nclient.subscribe('dbus/...')\n\n# Get devices\ndevices = client.devices\nprint(devices)\n\n# Wait for messages\nimport time\ntime.sleep(10)\nclient.stop()","lang":"python","description":"Connect to a Victron Venus OS MQTT broker and list available devices."},"warnings":[{"fix":"Upgrade Python to 3.13 or later.","message":"Python >=3.13 required. Older Python versions (3.12 and below) are not supported and will cause installation failures.","severity":"breaking","affected_versions":">=2026.6.0"},{"fix":"Use `client.subscribe('dbus/...')` with appropriate topic pattern.","message":"The method `client.subscribe_device()` has been deprecated in favor of `client.subscribe(topic_pattern)`. Old method may be removed in future releases.","severity":"deprecated","affected_versions":">=2026.5.0"},{"fix":"Set port parameter to 1883 if using standard MQTT, or enable WebSockets in Venus OS (Settings → MQTT).","message":"The library expects the MQTT broker to be running with WebSockets (port 9001) by default, not standard MQTT (1883). Ensure your Venus OS device has MQTT over WebSockets enabled.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2026.6.3':24 '3.13':27 'activ':28 'cerbo':18 'color':20 'communic':6 'control':21 'devic':16 'e.g':17 'energi':13,37 'frequent':30 'gx':19,22 'interfac':10 'librari':4 'maintain':29 'mqtt':2,9,33 'os':15,36 'python':3,26 'releas':31 'solar':38 'support':25 'venus':14,35 'venus-o':34 'version':23 'victron':1,12,32","created_at":"2026-06-07T13:01:29.512035+00:00","updated_at":"2026-06-07T13:01:29.512035+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/tomer-w/victron_mqtt","github":"https://github.com/tomer-w/victron_mqtt","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["iot"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}