HACS w Home Assistant: integracje i dodatki, które warto znać

HACS daje dostęp do rozszerzeń tworzonych przez społeczność Home Assistant. Może uzupełnić brakującą obsługę urządzenia, dodać specjalistyczne dane albo rozbudować dashboard. Nie jest jednak znakiem jakości ani zamiennikiem oficjalnego katalogu integracji.

Ten poradnik nie jest instrukcją instalacji HACS ani listą najpopularniejszych repozytoriów. Pokazuje kilka zastosowań, w których rozszerzenie społecznościowe wnosi konkretną wartość, oraz sytuacje, w których lepiej pozostać przy oficjalnym rozwiązaniu.

Oficjalne integracje są częścią Home Assistant Core. Przechodzą przegląd projektu, testy i wspólny proces aktualizacji. Problemy zgłasza się w ekosystemie Home Assistant, a zmiany są koordynowane z kolejnymi wydaniami systemu.

Projekt dostępny przez HACS pozostaje niezależnym repozytorium. HACS ułatwia pobranie plików i informuje o wydaniach, ale nie gwarantuje jakości kodu, bezpieczeństwa, zgodności ani czasu reakcji autora. Każdy projekt ma własny cykl życia. HACS nie jest też sklepem z dodatkami systemowymi Home Assistant. Zarządza między innymi niestandardowymi integracjami, kartami dashboardu, motywami i szablonami.

Jeżeli oficjalna integracja obsługuje potrzebne funkcje stabilnie, zwykle od niej warto zacząć. HACS ma sens wtedy, gdy rozwiązuje konkretny brak, daje potrzebne sterowanie lokalne albo dostarcza funkcję, której oficjalny Home Assistant nie oferuje.

• Oficjalny odpowiednik: sprawdź katalog integracji Home Assistant i zakres jego funkcji.
• Aktywność projektu: oceń ostatnie wydania, commity, otwarte problemy i reakcje opiekunów.
• Zakres dostępu: integracja może otrzymać token, hasło, dostęp do sieci lokalnej albo możliwość sterowania urządzeniem.
• Zależność od chmury: API producenta może zmienić logowanie, limity lub warunki usługi.
• Skutek awarii: karta dashboardu ma mniejsze znaczenie niż kod sterujący falownikiem, alarmem lub zamkiem.
• Plan odwrotu: wykonaj backup i sprawdź, jak usunąć integrację bez pozostawienia osieroconych encji i automatyzacji.

Co daje i dla kogo: Powercalc tworzy wirtualne sensory mocy i energii dla lamp, wentylatorów oraz innych urządzeń, które nie mają własnego pomiaru. Korzysta z profili urządzeń lub modelu zależnego od jasności, koloru czy trybu pracy. Może uzupełnić bilans energii, gdy montaż wielu mierników nie jest uzasadniony.

Oficjalny odpowiednik i sens HACS: Home Assistant obsługuje liczniki i panel Energia, ale nie ma oficjalnej integracji o takim katalogu modeli szacunkowych. HACS wnosi tu wyraźnie inną funkcję.

Stan i ograniczenia: projekt jest aktywnie rozwijany i ma regularne wydania. Wynik pozostaje estymacją. Nie zastępuje certyfikowanego licznika ani rzeczywistego pomiaru przy rozliczeniach i odbiornikach o zmiennym poborze.

Co daje i dla kogo: Solcast PV Forecast pobiera prognozę produkcji dla instalacji fotowoltaicznej. Dane można wykorzystać do planowania ładowania, grzania wody lub innych elastycznych zadań.

Oficjalny odpowiednik i sens HACS: Home Assistant ma oficjalną integrację Forecast.Solar. Solcast ma sens tylko wtedy, gdy jego model, konfiguracja wielu połaci albo dostępne dane lepiej pasują do danej instalacji. Nie jest automatycznie lepszym wyborem.

Stan i ograniczenia: repozytorium jest aktywne i publikuje wydania. Integracja zależy od zewnętrznego API, klucza i limitów zapytań. Prognoza nie jest pomiarem, a jej błędu nie wolno ignorować w automatyzacjach.

Co daje i dla kogo: integracja Huawei Solar udostępnia przez Modbus dane falownika, baterii, licznika i optymalizatorów. Może także oferować zaawansowane sterowanie eksportem lub ładowaniem, jeżeli instalacja i uprawnienia na to pozwalają.

Oficjalny odpowiednik i sens HACS: oficjalny katalog zawiera Huawei LTE, ale nie jest to integracja falowników Huawei Solar. W tym przypadku HACS wypełnia rzeczywistą lukę. Dla Fronius, SolarEdge, SolaX, GoodWe i innych marek trzeba najpierw sprawdzić oficjalną integrację, zamiast zakładać, że HACS będzie lepszy.

Stan i ograniczenia: projekt jest aktywnie utrzymywany i regularnie wydawany. Modbus zwykle dopuszcza jedno połączenie, kompatybilność zależy od modelu i firmware, a funkcje zapisu mogą wpływać na pracę instalacji. Sterowanie wymaga szczególnej ostrożności.

Co daje i dla kogo: integracja Frigate przekazuje do Home Assistant kamery, wykryte obiekty, zdarzenia, migawki, sensory wydajności i sterowanie nagrywaniem. Przydaje się osobom, które już używają Frigate jako lokalnego NVR.

Oficjalny odpowiednik i sens HACS: Home Assistant ma oficjalne ONVIF i integracje wielu kamer, ale nie odtwarzają one modelu zdarzeń Frigate. Twórcy Frigate nazywają swój komponent oficjalną integracją projektu, lecz technicznie jest on instalowany przez HACS i nie należy do Home Assistant Core.

Stan i ograniczenia: oba projekty są aktywnie rozwijane. Integracja wymaga działającego Frigate, poprawnej sieci oraz MQTT dla wielu encji. Sam HACS nie instaluje NVR i nie rozwiązuje kwestii wydajności, retencji nagrań ani prywatności obrazu.

Co daje i dla kogo: społecznościowa integracja OPNsense udostępnia bogatszą telemetrię routera i zapory, a w odpowiednich wersjach również wybrane elementy sterowania. Ma sens w rozbudowanej sieci, gdy dane infrastruktury mają trafiać do diagnostyki i automatyzacji.

Oficjalny odpowiednik i sens HACS: Home Assistant ma oficjalną, starszą integrację OPNsense skupioną głównie na wykrywaniu obecności. Jeżeli to wystarcza, jest prostszym wyborem. HACS jest uzasadniony dopiero przy potrzebie szerszych sensorów lub funkcji.

Stan i ograniczenia: hass-opnsense jest aktywnie rozwijany i określa wymagane wersje firmware. Dostęp API powinien mieć minimalne uprawnienia. Akcje zmieniające zaporę lub NAT mają większe ryzyko niż sam odczyt danych i nie powinny być przypadkowo wystawiane w automatyzacjach.

Co daje i dla kogo: integracja Kia Uvo i Hyundai Bluelink może udostępnić stan pojazdu, zasięg, ładowanie oraz wybrane polecenia w obsługiwanych regionach. Oficjalnego odpowiednika Home Assistant dla tych usług obecnie nie ma.

Dlaczego HACS tylko warunkowo: projekt ma dużą historię zmian i nadal otrzymuje poprawki, ale główny autor otwarcie informuje, że nie ma już takiego samochodu i szuka dodatkowych opiekunów. To ważny sygnał przed powiązaniem integracji z istotnymi automatyzacjami.

Ograniczenia: rozwiązanie korzysta z nieoficjalnego API producenta, zależy od regionu i może przestać działać po zmianie logowania. Zbyt częste odświeżanie może obciążać usługę lub budzić samochód. Dla Tesli warto najpierw wybrać oficjalne integracje Tesla Fleet lub Teslemetry, a nie dawny komponent HACS.

Co daje i dla kogo: aktywny fork LocalTuya obsługuje zgodne urządzenia Tuya bez bieżącego kierowania poleceń przez chmurę. Może poprawić czas reakcji i zachować podstawowe sterowanie podczas awarii internetu.

Oficjalny odpowiednik i sens HACS: oficjalna integracja Tuya jest łatwiejsza i powinna być pierwszym wyborem, jeśli zapewnia potrzebne encje. LocalTuya ma sens przy świadomej potrzebie sterowania lokalnego albo funkcji brakujących w oficjalnej integracji.

Stan i ograniczenia: wskazany fork xZetsubou jest aktywnie rozwijany, podczas gdy starszego repozytorium rospogrigio nie należy traktować jako najlepszego punktu startu. Konfiguracja zależy od kluczy lokalnych, identyfikatorów DP i wersji protokołu. Część urządzeń może nadal wymagać chmury podczas konfiguracji.

Co daje i dla kogo: Browser Mod może zarejestrować konkretną przeglądarkę jako urządzenie, otworzyć widok kamery po dzwonku, sterować nawigacją, wyświetlać okna i używać ekranu jako odtwarzacza. Jest szczególnie przydatny przy tabletach ściennych.

Oficjalny odpowiednik i sens HACS: Home Assistant ma dashboardy, tryb kiosk i aplikacje mobilne, ale nie oferuje pełnego odpowiednika z adresowaniem konkretnej sesji przeglądarki. HACS daje tu funkcję ponad standardowy interfejs.

Stan i ograniczenia: projekt jest aktywnie utrzymywany. Mocno zależy od zmian frontendu i pamięci podręcznej przeglądarki. Po aktualizacji może być potrzebne pełne przeładowanie, a krytyczne sterowanie nie powinno zależeć wyłącznie od działającej karty przeglądarki.

Mushroom: zestaw spójnych, kompaktowych kart do czytelnych paneli mobilnych i tabletowych. Projekt pozostaje aktywny. Oficjalne Tile Cards pokrywają coraz więcej podobnych potrzeb, dlatego Mushroom warto dodawać dla konkretnego układu lub funkcji, a nie tylko dla zmiany wyglądu.

Power Flow Card Plus: rozbudowuje wizualizację przepływów między siecią, fotowoltaiką, baterią, domem i wybranymi odbiornikami. Oficjalny panel Energia nadal jest lepszym miejscem dla danych historycznych. Karta HACS ma sens jako bieżący, bardziej konfigurowalny podgląd.

Ryzyko: karty są kodem uruchamianym w przeglądarce. Po aktualizacji Home Assistant mogą wymagać nowej wersji lub zmiany konfiguracji. Zbyt wiele niestandardowych kart zwiększa czas ładowania i utrudnia serwis panelu.

Co daje i dla kogo: Watchman skanuje konfigurację i raportuje odwołania do brakujących lub niedostępnych encji oraz nieistniejących akcji. Przydaje się po zmianach nazw, usuwaniu urządzeń i większych aktualizacjach.

Oficjalny odpowiednik i sens HACS: naprawy, logi i ślady automatyzacji w Home Assistant pokazują wiele problemów, ale nie tworzą takiego samego przekrojowego raportu odwołań. Watchman uzupełnia narzędzia administratora.

Stan i ograniczenia: projekt jest aktywnie utrzymywany. Parser używa lekkich heurystyk i nie rozumie całej logiki konfiguracji, dlatego możliwe są fałszywe alarmy i przeoczenia. Raport pomaga w przeglądzie, lecz nie zastępuje testów automatyzacji.

Przed aktualizacją przeczytaj informacje o wydaniu, sprawdź wymaganą wersję Home Assistant i wykonaj kopię zapasową możliwą do pobrania poza urządzenie. Aktualizacja samego HACS nie aktualizuje automatycznie wszystkich pobranych repozytoriów.

Nie instaluj kilku projektów rozwiązujących ten sam problem. Usuń nieużywane rozszerzenia razem z encjami, zasobami dashboardu i odwołaniami w automatyzacjach. Po większej aktualizacji sprawdź logi, naprawy, kluczowe panele oraz działanie urządzeń.

Najbezpieczniejsza konfiguracja nie ma najwięcej dodatków. Ma tylko te, których wartość jest większa od kosztu aktualizacji, diagnostyki i dodatkowego dostępu do systemu.

Najpierw wybierz oficjalną integrację, jeśli stabilnie realizuje potrzebne zadanie. Po HACS sięgaj wtedy, gdy potrafisz nazwać brakującą funkcję i zaakceptować odpowiedzialność za dodatkową zależność.

Powercalc, wyspecjalizowana obsługa PV, integracja Frigate, lokalne Tuya czy narzędzia diagnostyczne mogą realnie rozbudować system. Każdy taki projekt trzeba jednak oceniać osobno, na podstawie aktualnej dokumentacji, aktywności i skutków ewentualnej awarii.

Jeżeli chcesz bezpiecznie dobrać rozszerzenie, ocenić jego stan albo połączyć kilka systemów w Home Assistant, mogę pomóc sprawdzić możliwości, ograniczenia i przygotować właściwą konfigurację.

• Dokumentacja HACS: repozytoria i aktualizacje
• Oficjalny katalog integracji Home Assistant
• Powercalc, Solcast PV Forecast i Huawei Solar
• Frigate, hass-opnsense i Hyundai Kia Connect
• LocalTuya, Browser Mod i Watchman
• Mushroom i Power Flow Card Plus