C.A.F.E. (Editor Complesso di Flusso di Automazione) è un’integrazione che aggiunge a Home Assistant un editor visivo “in flusso”, un po’ nello spirito di Node-RED, ma con una differenza fondamentale: C.A.F.E. non è un motore di esecuzione. Home Assistant rimane l’unico a eseguire le tue automazioni. C.A.F.E. si limita a trasformare il tuo schema visivo in YAML 100% conforme e memorizzato direttamente nel sistema Home Assistant.
In parole semplici, disegni la logica con blocchi collegati da frecce, poi salvi… e Home Assistant esegue come al solito. Nessun contenitore Docker da aggiungere, nessun database da mantenere, nessun addon che diventa il punto debole, come avviene con Node-Red. È esattamente la promessa “zero sovraccarico” messa in evidenza dal progetto.
Perché è interessante per Home Assistant
Se ti piace il YAML, sai già perché: è robusto, nativo, prevedibile… ma appena un’automazione cresce, ci si ritrova presto con un muro di testo. C.A.F.E. punta proprio a quel momento in cui “diventa un piatto di spaghetti”. Sa leggere un’automazione esistente e ricostruire una mappa visiva, il che è molto utile per auditare, capire, ristrutturare.
Se provenivi da Node-RED, la parte rassicurante sta altrove: ritrovi una logica a nodi, ma senza spostare l’esecuzione al di fuori di Home Assistant. C.A.F.E. cambia l’interfaccia, non il motore, e puoi tornare all’editor nativo in qualsiasi momento.
Ci sono anche due “bonus” che parlano a molte persone :
- C.A.F.E. gestisce meglio la nozione di variabili lato interfaccia visiva, mentre l’editor visivo nativo di Home Assistant costringe spesso a mettere le mani nello YAML per questo genere di cose.
- C.A.F.E. si integra con la trace di Home Assistant: l’obiettivo è mantenere il debug negli strumenti ufficiali, senza inventare un universo parallelo.
Il “truc” intelligente: niente blocco, niente formato esotico
È probabilmente l’argomento più rassicurante: se disinstalli C.A.F.E., le tue automazioni continuano a funzionare. Perdi soprattutto il layout visivo (posizioni dei blocchi), non la logica, poiché resta YAML standard.
E per mantenere questo layout, C.A.F.E. memorizza metadati (posizioni dei nodi, ecc.) in un oggetto “inoffensivo” all’interno del blocco variables dell’automazione. Puoi modificare un’automazione in Home Assistant, poi riaprirla in C.A.F.E.: entrambi editano la stessa fonte.
Installazione di C.A.F.E. in Home Assistant (via HACS)
Il metodo consigliato passa per HACS, con aggiunta del repository personalizzato. Il README ufficiale fornisce le istruzioni: in HACS, sezione Integrazioni, menu dei tre punti, “Repository personalizzati”, poi aggiunta di https://github.com/FezVrasta/cafe-hass come integrazione.
Successivamente, trovi C.A.F.E. in HACS, e lo installi (scarichi).
Riavvia Home Assistant, poi aggiungi l’integrazione C.A.F.E. tramite Impostazioni → Dispositivi e servizi → Aggiungi un’integrazione.
Una volta in posizione, C.A.F.E. appare nella barra laterale di Home Assistant sotto forma di pannello. Non è un “dashboard” Lovelace, ma una voce nella sidebar.
Vuoi provare senza installare?
È possibile provare C.A.F.E. senza installare niente, tramite un’interfaccia web, a condizione di avere un accesso remoto a Home Assistant.
In pratica, tieni a mente che esporre Home Assistant su Internet deve avvenire in modo appropriato (Nabu Casa, reverse proxy, autenticazione, ecc.). È fattibile, ma si evita la modalità “yolo” quando si tratta di domotica.
Se non vuoi dare accesso al tuo Home Assistant (cosa totalmente comprensibile), ti ho installato C.A.F.E. sul server di test Home Assistant che ti ho messo a disposizione da qualche settimana, il che ti permetterà di testare in condizioni senza rompere nulla a casa tua né avere bisogno di dare un accesso remoto ;-)
Primi passi: come si usa quotidianamente
Una volta in C.A.F.E., l’interfaccia è molto “flow editor”: una palette di nodi a sinistra (attivatori, condizioni, azioni, ritardi, attese…), un grande canvas centrale dove si posizionano i blocchi, e un pannello delle proprietà a destra per configurare ogni nodo. Puoi zoomare, muoverti, e anche utilizzare una mini-mappa per navigare in automazioni complesse.
Lo scenario tipico sembra così: posizioni un attivatore (ad esempio “movimento rilevato”), aggiungi una condizione (ad esempio “è notte”), poi un’azione (ad esempio “accendere la lampada del corridoio”), e colleghi il tutto. Poi apri ogni nodo per selezionare entità e servizi. C.A.F.E. si basa sull’intelligenza delle entità lato Home Assistant (auto-completamento, conoscenza degli stati tramite API) per evitare di digitare identificativi a mano.
Punto molto pratico: puoi aprire un’automazione esistente, vederla “posarsi” sul canvas, spostare i blocchi per chiarire, modificare, poi salvare in Home Assistant. Modifichi, salvi, e ritrovi l’automazione nell’editor nativo, con YAML arricchito dai metadati di layout!
Importare, esportare, fare debug
C.A.F.E. sa importare un’automazione esistente e può anche importare YAML o JSON, poi esportare un flusso in JSON. È utile per condividere uno “schema” o archiviare una versione prima di rifare una logica un po’ delicata.
Per quanto riguarda il debug, l’idea è semplice: mantenere una lettura chiara dell’esecuzione. Si trova una modalità di debug con indicatore di “passo dopo passo” e opzioni per simulare risultati di condizioni, per visualizzare il percorso intrapreso nell’automazione.
E riguardo al progetto, l’integrazione con la Trace View di Home Assistant è uno dei punti forti annunciati: rimani negli strumenti ufficiali per analizzare cosa è successo.
Esempi concreti in cui C.A.F.E. fa davvero la differenza
Pensa a un’automazione “luci della sera” un po’ realistica. Attivazione: poco prima del tramonto. Condizione: solo se siamo prima di una certa ora (altrimenti è troppo tardi, inutile). Azione: accendere alcune lampade, ma con una luminosità diversa a seconda di una finestra temporale. In YAML, spesso finisce in “choose” nidificati e condizioni che si incrociano. In C.A.F.E., questo tipo di logica diventa una mappa stradale: vediamo i rami, vediamo i percorsi, respiriamo. E questo è esattamente il tipo di esempio mostrato nella trascrizione.
Un altro caso molto chiaro: gli scenari con variabili. Esempio banale: chiami uno script che restituisce un’informazione (temperatura, tariffa, stato sintetizzato), memorizzi la risposta in una variabile, poi riutilizzi questa variabile in azioni successive, tramite template Jinja. Il README spiega il meccanismo delle “script responses” (response_variable) e l’uso in Jinja {{ variable.champ }} nei nodi successivi.
E per gli installatori o gli utenti avanzati: non appena si parla di cicli, di ritorni indietro, di logiche non lineari, C.A.F.E. annuncia una compilazione “ottimizzata” che può generare una struttura tipo “state machine” quando necessario, rimanendo completamente compatibile con Home Assistant.
Limiti e precauzioni (perché sì, è una beta)
Il progetto è presentato come “non distruttivo”, ma rimane in beta, con correzioni frequenti. Prima regola: fai una copia di sicurezza delle tue automazioni prima di modificare cose importanti.
Seconda regola: su un’automazione critica (allarme, riscaldamento, sicurezza), procedi gradualmente. Testa prima su un’automazione semplice, confronta il YAML prima/dopo, verifica il tracciamento, poi aumenta in complessità. È un po’ il metodo “non ristrutturiamo una casa rompendo tutti i muri contemporaneamente” (e la tua futura tranquillità ti ringrazierà!).
Terza regola: accetta l’idea che l’auto-layout e la ricostruzione visiva non saranno perfetti al 100% su YAML molto artigianale. Il progetto lo riconosce: l’import di YAML manuale complesso può presentare delle asperità.
Dovresti adottarlo ora?
Se ti senti a tuo agio con l’editor nativo e le tue automazioni rimangono semplici, C.A.F.E. non è “obbligatorio”. Tuttavia, se hai scenari che vanno in tutte le direzioni, se odi rileggere YAML lungo come un giorno senza Wi-Fi, o se ti piace il comfort visivo di Node-RED ma senza voler un secondo motore, C.A.F.E. segna molti punti: visivo, nativo, senza sovraccarico e senza trappole a lungo termine poiché rimane su automazioni standard di Home Assistant. Qui, in ogni caso, è adottato!
