Brings Process Mining to Home Assistant as an Add-on.
This repository is a Home Assistant deployment wrapper for the actual SmartHomeProcessMining application.
Process mining turns event logs into understandable models of real-world behavior. Smart homes already generate rich logs through device state changes and automations, so you can use these techniques to:
- Discover real routines and occupancy patterns
- Spot anomalies or inefficiencies in automation flows
- Optimize energy usage based on actual device sequences
- Visualize how daily processes evolve over time
The motivation for this project is to bring these analytical insights to Home Assistant users so they can understand and improve their smart home behavior using the existing logbook data.
Guide for Home Assistant Add-on configuration: DOCS
Installation without Home Assistant environment: SmartHomeProcessMining
This repository mainly contains the Home Assistant add-on packaging and points to the real application via a git submodule.
process_management/: Home Assistant add-on definition, Dockerfile, andconfig.yaml.process_management/app/SmartHomeProcessMining/: git submodule with the actual process mining application code.repository.yaml: metadata for the Home Assistant add-on repository.
Because the application lives in the submodule, you need to initialize it when working locally:
git submodule update --init --recursive