Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Inventory management for DistKV

Project description

DistHASS is a link between Home Assistant and DistKV.

It will

  • set up standard config for Home Assistant in DistKV
  • have command-line support to register (or not) devices

Principle of Operation

Home Assistant talks via MQTT. DistKV has a quite versatile MQTT adapter. Thus we can store Home Assistant’s entitiy configuration, plus their state, plus the commands Home Assisant issues to get things to change their state, in DistKV.

MQTT can only transmit binary data. DistHASS thus creates a few codecs that support binary data (translating them to on/off), integers/floats, and JSON.

Thus, bottom to top:

  • Mosquitto on port 51883
    • basic installation, does not need persistence or retained messages
    • Serf would work, but it imposes additional delays
  • DistKV, using Mosquitto as a backbone
    • a special user with conversion rules for JSON etc.
  • DistMQTT
    • retained messages are stored in DistKV
    • transparent channels to forward MQTT messages unmodified, if required
    • anything else is broadcast as a DistKV message
    • uses port 1883
  • Home Assistant, or anything else MQTTish for that matter
    • must use MQTT 3.11

If you have devices that only can use MQTT 3.1, you can teach them to talk directly to Mosquitto, via a transparent range.


  • Run distkv client hass init -i

  • Add a DistKV user for Home Assistant and set its conv parameter to hassco:

    distkv client auth user param NAME conv hassco
  • Start DistMQTT:

            host: ''
            port: 27586
            auth: "password name=NAME password=PASSWORD"
        topic: [mqtt, msg]
        - [home,ass,event]
        - [home,ass,state]
        retain: [home, ass]
            max-connections: 500
            type: tcp
    timeout-disconnect-delay: 2
    plugins: ['auth_anonymous']
        allow-anonymous: true

    If you have devices that cannot talk via DistMQTT, modify the transparent list to include the MQTT prefixes you currently use.

  • Modify Home Assistant’s MQTT integration to do autodiscovery. If you’ve set it up via the GUI, the file you need is .storage/core.config_entries. Find the entry with "domain": "mqtt" and modify its data entry to read:

    "data": {
        "broker": "",
        "discovery": true,
        "discovery_prefix": "home/ass/dyn",
        "port": 1883,
  • Restart Home Assistant.

  • Run distkv client hass add light foo bar.

    A new light should show up in the Home Assistant GUI.

    You can try to turn it on, but it will go off by itself a second or two later because there’s no device yet.

  • Run distkv client hass state light foo bar True.

    This command changes the state manually.

    In Home Assistant, the light turns on.

  • Adding an actual device that monitors the light’s DistKV command entry / its [Dist]MQTT command topic, actually affects the hardware, and changes the state, is your job.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for disthass, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size disthass-0.2.3.tar.gz (8.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page