Instalace HACS do Home Assistantu

Přidejte HACS a odemkněte stovky vlastních karet, integrací a motivů

📦 Typ: Návod Začátečník ⏱️ Čas: cca 10 minut 🌐 smarthome4u.cz
📋 Obsah návodu
🏪 Co je HACS a proč ho potřebujete

HACS (Home Assistant Community Store) je obchod s doplňky pro Home Assistant vytvořený komunitou uživatelů. Díky HACS můžete do HA jednoduše instalovat stovky věcí, které v základní instalaci chybí – přímo z prostředí HA, na pár kliknutí.

ℹ️ Pro koho je tento návod

Návod nevyžaduje žádné příkazy v terminálu ani technické znalosti. Vše provedete klikáním přímo v Home Assistantu. Potřebujete pouze přístup k HA a e-mailovou adresu pro vytvoření bezplatného GitHub účtu.

🐙 Krok 1 – Vytvořte si GitHub účet

HACS vyžaduje propojení s GitHub účtem. GitHub je platforma pro sdílení kódu – registrace je zdarma a stačí e-mailová adresa. Pokud účet již máte, přejděte rovnou na další krok.

  1. Klikněte na tlačítko níže – otevře se registrační stránka GitHubu
  2. Zadejte svůj e-mail, zvolte heslo a uživatelské jméno Uživatelské jméno vidíte pouze vy – ostatní uživatelé HA ho neuvidí.
  3. Potvrďte e-mailovou adresu kliknutím na odkaz v e-mailu od GitHubu
⬇️ Krok 2 – Instalace HACS

Instalace probíhá přímo v prostředí Home Assistantu přes sekci Aplikace – žádný terminál ani technické znalosti nejsou potřeba.

  1. Přejděte do Nastavení → Aplikace V levém menu klikněte na „Nastavení“ a poté v seznamu zvolte „Aplikace“.
  2. Klikněte na tlačítko Nainstalovat aplikaci v pravém dolním rohu – otevře se obchod s aplikacemi
  3. V obchodě klikněte na ikonu tří teček ⋮ v pravém horním rohu a zvolte Repozitáře
  4. Do textového pole zadejte adresu HACS repozitáře a klikněte na Přidat – použijte tlačítko pro kopírování:
    https://github.com/hacs/addons
  5. Zavřete dialog – v obchodě se automaticky zobrazí nová sekce s HACS repozitářem
  6. Do vyhledávacího pole v obchodě napište HACS a klikněte na Get HACS Pokud Get HACS ve vyhledávání nevidíte, zkuste obchod obnovit (F5) – repozitář se přidá jako nová sekce a poté bude dostupný přes vyhledávání.
  7. Klikněte na Instalovat a počkejte na dokončení
  8. Po instalaci klikněte na Spustit
  9. Klikněte na záložku Protokol a počkejte, dokud přestane přibývat nový text – instalace je hotová Protokol se průběžně aktualizuje. Jakmile poslední řádek hlásí úspěch a text se dále nemění, pokračujte dalším krokem.
🔧 Krok 3 – Aktivace HACS v Home Assistantu

Po dokončení instalace restartujte HA a HACS přidejte jako integraci.

  1. Přejděte do Nastavení a vpravo nahoře klikněte na ⋮ (tři tečky). Zvolte Restartovat Home Assistanta a potvrďte tlačítkem Restartovat Počkejte, dokud se HA úplně nenačte – může to trvat 1–2 minuty.
  2. Přejděte do Nastavení → Zařízení a služby
  3. Klikněte na Přidat integraci v pravém dolním rohu
  4. Do vyhledávacího pole napište HACS a klikněte na výsledek
  5. Přečtěte si podmínky, zaškrtněte všechna políčka a klikněte na Odeslat
🔗 Krok 4 – Propojení HACS s GitHub účtem

Jako poslední krok se HACS ověří přes váš GitHub účet. Toto provedete jednou – poté HACS funguje bez dalšího přihlašování.

  1. Na obrazovce se zobrazí osmimístný kód – nechte toto okno otevřené
  2. Klikněte na odkaz github.com/login/device zobrazený pod kódem – otevře se v nové záložce
  3. Přihlaste se ke svému GitHub účtu (pokud ještě nejste přihlášeni)
  4. Zadejte osmimístný kód z Home Assistantu a klikněte na Continue
  5. Klikněte na zelené tlačítko Authorize HACS
  6. Zavřete záložku GitHubu a vraťte se do Home Assistantu – dialog se automaticky dokončí
  7. Přiřaďte HACS do místnosti (volitelné) a klikněte na Dokončit
✅ HACS je nainstalovaný a připravený!

V levém menu Home Assistantu se objevila nová položka HACS. Klikněte na ni a začněte procházet doplňky. Karty pro ovládací panely poznáte podle typu Ovládací panel ve sloupci Typ – doporučujeme začít s Mushroom nebo Bubble Card.

❓ Časté dotazy a chyby
V sekci Aplikace nevidím „Get HACS“ ani po přidání repozitáře
Zkuste stránku Aplikací obnovit (F5). Pokud Get HACS stále chybí, zkontrolujte, zda jste repozitář zadali správně – adresa musí být přesně https://github.com/hacs/addons bez mezer nebo dalšího textu na konci.
HACS se nezobrazuje v seznamu integrací ani po restartu
Nejčastější příčina je nevyčištěná cache prohlížeče. Stiskněte Ctrl+Shift+R (nebo Cmd+Shift+R na Macu). Pokud nepomůže, zkuste HA otevřít v jiném prohlížeči nebo v anonymním okně.
Kód pro GitHub mi vypršel nebo jsem ho nestihl zadat
Kódy platí přibližně 15 minut. Pokud vypršel, odstraňte integraci HACS v Nastavení → Zařízení a služby → HACS → Odstranit a přidejte ji znovu. Aplikaci Get HACS nemusíte znovu instalovat – jen se spustí nový proces ověření.
Nainstaloval jsem kartu z HACS, ale nevidím ji v editoru ovládacího panelu
Po instalaci karty proveďte tvrdé obnovení stránky (Ctrl+Shift+R). Pokud karta stále chybí, přejděte do Nastavení → Ovládací panely → ⋮ (tři tečky) vpravo nahoře → Zdroje a zkontrolujte, zda je tam JavaScript soubor karty přidán – HACS ho přidává automaticky, ale někdy je potřeba stránku znovu načíst.
💬 Potřebujete pomoc?

Navštivte smarthome4u.cz, kde najdete další návody pro Home Assistant. Nebo nás kontaktujte přímo na smarthome4u.cz/kontakt.