C.A.F.E. (Complex Automation Flow Editor) adalah sebuah integrasi yang menambahkan kepada Home Assistant editor visual “aliran”, sedikit mirip dengan Node-RED, tetapi dengan perbedaan utama: C.A.F.E. bukanlah mesin eksekusi. Home Assistant tetap menjadi satu-satunya yang menjalankan otomatisasi Anda. C.A.F.E. hanya mengubah skema visual Anda menjadi YAML yang 100% sesuai dan disimpan langsung di dalam sistem Home Assistant.
Secara jelas, Anda menggambar logika dengan blok yang terhubung oleh panah, lalu Anda menyimpan… dan Home Assistant menjalankan seperti biasa. Tidak ada kontainer Docker yang perlu ditambahkan, tidak ada basis data yang harus dipelihara, tidak ada addon yang menjadi titik lemah, seperti yang terjadi dengan Node-Red. Ini adalah janji “bebas beban” yang ditekankan oleh proyek ini.
Mengapa ini menarik untuk Home Assistant
Jika Anda menyukai YAML, Anda sudah tahu mengapa: itu tangguh, asli, dapat diprediksi… tetapi begitu sebuah otomatisasi berkembang, Anda dengan cepat menemukan dinding teks. C.A.F.E. secara tepat menargetkan momen dimana “itu menjadi tumpukan spaghetti”. Ia dapat membaca otomatisasi yang ada dan membangun kembali peta visual, yang sangat berguna untuk audit, memahami, merapikan kembali.
Jika Anda berasal dari Node-RED, sisi yang meyakinkan berada di tempat lain: Anda menemukan logika berbasis node, tetapi tanpa membalikkan eksekusi keluar dari Home Assistant. C.A.F.E. mengubah antarmuka, bukan mesinnya, dan Anda dapat kembali ke editor asli kapan saja.
Ada juga dua “bonus” yang menarik bagi banyak orang:
- C.A.F.E. lebih baik dalam mengelola konsep variabel di sisi antarmuka visual, sementara editor visual asli dari Home Assistant sering kali memaksa untuk mengotak-atik YAML untuk hal-hal semacam ini.
- C.A.F.E. terintegrasi dengan jejak Home Assistant: tujuannya adalah untuk menjaga debugging di alat resmi, tanpa menciptakan universe paralel.
Trik pintar: tidak ada penguncian, tidak ada format eksotis
Ini mungkin argumen yang paling meyakinkan: jika Anda mencopot C.A.F.E., otomatisasi Anda akan tetap berfungsi. Anda terutama kehilangan tata letak visual (posisi blok), bukan logika, karena tetap dalam YAML standar.
Dan untuk mempertahankan tata letak ini, C.A.F.E. menyimpan metadata (posisi node, dll.) dalam objek “tidak berbahaya” di dalam blok variables dari otomatisasi. Anda dapat memodifikasi sebuah otomatisasi dalam Home Assistant, kemudian membukanya kembali di C.A.F.E.: keduanya mengedit sumber yang sama.
Instalasi C.A.F.E. di Home Assistant (via HACS)
Metode yang dianjurkan melalui HACS, dengan menambah repository kustom. README resmi memberikan langkah-langkahnya: di HACS, bagian Integrasi, menu tiga titik, “Repository kustom”, kemudian tambahkan https://github.com/FezVrasta/cafe-hass sebagai integrasi.
Setelah itu, temukan C.A.F.E. di HACS, dan instal (unduh).
Menghidupkan kembali Home Assistant, lalu menambahkan integrasi C.A.F.E. melalui Pengaturan → Perangkat dan layanan → Tambah integrasi.
Setelah terpasang, C.A.F.E. muncul di bilah samping Home Assistant sebagai panel. Ini bukan “dashboard” Lovelace, melainkan entri di sidebar.
Ingin menguji tanpa instalasi?
Anda dapat mencoba C.A.F.E. tanpa perlu menginstal apa pun, melalui antarmuka web, asalkan Anda memiliki akses jarak jauh ke Home Assistant.
Dalam praktiknya, ingat bahwa mengekspos Home Assistant di Internet harus dilakukan dengan bersih (Nabu Casa, reverse proxy, otentikasi, dll.). Ini bisa dilakukan, tetapi hindari mode “yolo” ketika berurusan dengan automasi.
Jika Anda tidak ingin memberikan akses ke Home Assistant Anda (yang sepenuhnya bisa dimengerti), saya telah memasang C.A.F.E. di server uji Home Assistant yang telah saya sediakan untuk Anda selama beberapa minggu, yang memungkinkan Anda untuk menguji dalam kondisi tanpa merusak apapun di rumah Anda atau memerlukan akses jarak jauh ;-)
Pengaturan: bagaimana cara menggunakannya dalam kehidupan sehari-hari
Setelah berada di C.A.F.E., antarmukanya sangat mirip dengan “flow editor”: palet node di sebelah kiri (pemicu, kondisi, aksi, waktu tunda, penantian…), kanvas besar di tengah untuk menjatuhkan blok, dan panel properti di sebelah kanan untuk mengkonfigurasi setiap node. Anda dapat memperbesar, bergerak, dan bahkan menggunakan peta mini untuk menavigasi dalam otomatisasi yang kompleks.
Skema tipikal terlihat seperti ini: Anda menjatuhkan sebuah pemicu (misalnya “gerakan terdeteksi”), Anda menambahkan sebuah kondisi (misalnya “gelap”), lalu sebuah aksi (misalnya “menyalakan lampu lorong”), dan Anda menghubungkan semuanya. Setelah itu, Anda membuka setiap node untuk memilih entitas dan layanan. C.A.F.E. memanfaatkan kecerdasan entitas di sisi Home Assistant (auto-completion, pengetahuan status melalui API) untuk menghindari pengetikan ID secara manual.
Poin yang sangat praktis: Anda dapat membuka otomatisasi yang ada, melihatnya “ditempatkan” di kanvas, memindahkan blok untuk lebih memperjelas, mengedit, lalu menyimpan di Home Assistant. Anda mengedit, menyimpan, dan menemukan otomatisasi di editor asli, dengan YAML yang diperkaya oleh metadata tata letak!
Impor, ekspor, debugging
C.A.F.E. dapat mengimpor otomatisasi yang ada dan juga dapat mengimpor YAML atau JSON, kemudian mengekspor flow dalam JSON. Ini berguna untuk berbagi “skema” atau mengarsipkan versi sebelum merombak logika yang agak rumit.
Di sisi debug, idenya sederhana: menjaga pembacaan yang jelas dari eksekusi. Ada mode debugging dengan indikator “step by step” dan opsi untuk mensimulasikan hasil kondisi, untuk memvisualisasikan jalur yang diambil dalam otomatisasi.
Dan di sisi proyek, integrasi dengan Trace View Home Assistant adalah salah satu titik kuat yang diumumkan: Anda tetap berada di alat resmi untuk menganalisis apa yang terjadi.
Contoh konkret di mana C.A.F.E. benar-benar membuat perbedaan
Ambil otomatisasi “lampu malam” yang sedikit realistis. Pemicu: tepat sebelum matahari terbenam. Kondisi: hanya jika kita sebelum waktu tertentu (kalau tidak, terlambat, tidak berguna). Aksi: menyalakan beberapa lampu, tetapi dengan tingkat kecerahan yang berbeda tergantung pada jendela waktu. Dalam YAML, ini sering kali berakhir dengan “choose” bersarang dan kondisi yang saling tumpang tindih. Di C.A.F.E., jenis logika ini menjadi peta jalan: kita melihat percabangan, kita melihat jalan, kita bisa bernapas. Dan ini adalah tipe contoh yang ditunjukkan dalam transkripsi.
Contoh lain yang sangat jelas: skenario dengan variabel. Contoh sangat sederhana: Anda memanggil skrip yang mengembalikan informasi (suhu, tarif, status sintetis), Anda menyimpan respons dalam sebuah variabel, lalu Anda menggunakan kembali variabel ini dalam aksi lanjutan, melalui template Jinja. README menjelaskan mekanisme “script responses” (response_variable) dan penggunaannya di Jinja {{ variable.champ }} di node-node berikut.
Dan untuk para installer atau pengguna lanjutan: begitu kita berbicara tentang loop, pengembalian, logika non-linier, C.A.F.E. mengumumkan kompilasi “dioptimalkan” yang dapat menghasilkan struktur tipe “state machine” jika diperlukan, sembari tetap 100% kompatibel dengan Home Assistant.
Batasan dan langkah hati-hati (karena ya, ini adalah versi beta)
Proyek ini disajikan sebagai “tidak destruktif”, tetapi masih dalam versi beta, dengan perbaikan yang sering. Aturan pertama: buat cadangan dari otomatisasi Anda sebelum mengubah hal-hal penting.
Aturan kedua: pada otomatisasi yang kritis (alarma, pemanasan, keamanan), lakukan secara bertahap. Uji dulu pada otomatisasi sederhana, bandingkan YAML sebelum/setelah, periksa jejaknya, lalu tingkatkan kompleksitas. Ini sedikit seperti metode “tidak merombak rumah dengan merobohkan semua dinding sekaligus” (dan ketenangan Anda di masa depan akan berterima kasih!).
Aturan ketiga: terima kenyataan bahwa auto-layout dan pengulangan visual tidak akan 100% sempurna pada YAML yang sangat kerajinan. Proyek ini mengakui: impor YAML manual yang rumit bisa memiliki ketidaksempurnaan.
Haruskah Anda mengadopsi sekarang?
Jika Anda sudah akrab dengan editor asli dan otomatisasi Anda tetap sederhana, C.A.F.E. tidak “wajib”. Namun, jika Anda memiliki skenario yang berjalan ke segala arah, jika Anda benci membaca YAML panjang seperti hari tanpa Wi-Fi, atau jika Anda menyukai kenyamanan visual dari Node-RED tetapi tidak ingin mesin kedua, C.A.F.E. mencentang banyak kotak: visual, asli, tanpa beban, dan tanpa jebakan jangka panjang karena kita tetap pada otomatisasi Home Assistant standar. Di sini, setidaknya, itu telah diadopsi!
