Anuncio

Guía HACS Home Assistant: Instala Integraciones y Tarjetas

Seguramente acabas de dar el gran salto. Has dejado atrás las aplicaciones limitadas de los fabricantes y has instalado tu propio servidor domótico. Al principio, todo es emocionante: luces que se encienden, sensores que responden, y la sensación de tener el control total. Sin embargo, empiezas a navegar por foros o vídeos de YouTube y ves paneles de control espectaculares, con diseños increíbles y dispositivos que, misteriosamente, no aparecen en tu lista oficial de integraciones.

Sientes frustración. Te preguntas: «¿Por qué mi panel se ve tan soso? ¿Por qué no puedo conectar ese electrodoméstico específico si otros usuarios sí pueden?» El dolor de sentir que te estás perdiendo el verdadero potencial de tu hogar inteligente es muy real para las personas que disponen de poco tiempo y quieren resultados rápidos.

Tranquilo, no estás haciendo nada mal. Lo que te falta es la «llave maestra» del ecosistema: la Home Assistant Community Store. Hoy vamos a aprender a instalar HACS en Home Assistant. Esta guía está diseñada paso a paso, de forma clara y sin tecnicismos innecesarios, para que en menos de 15 minutos conviertas tu sistema básico en una máquina domótica sin límites.

Pantalla de ordenador mostrando el panel de control de HACS en Home Assistant rodeado de iconos de smart home

¿Qué es HACS y por qué es absolutamente imprescindible?

Antes de meternos en faena, vamos a entender qué estamos instalando. HACS son las siglas de Home Assistant Community Store (Tienda de la Comunidad de Home Assistant).

Home Assistant tiene cientos de integraciones oficiales que son revisadas rigurosamente por sus desarrolladores. Pero el mundo de la tecnología avanza demasiado rápido. Si sale al mercado un nuevo robot aspirador o una marca de luces de bajo coste, la comunidad de programadores independientes crea el código para integrarlo en días, mucho antes de que se haga «oficial».

HACS actúa como una tienda de aplicaciones (como la Google Play Store o la App Store de Apple), pero totalmente gratuita y mantenida por voluntarios. Te permite instalar con un solo clic:

  • Integraciones: El «cerebro» para conectar aparatos de marcas que no tienen soporte oficial.
  • Frontend (Tarjetas y Temas): El «maquillaje» para que tu panel (conocido como Lovelace) luzca profesional, con botones animados, gráficos detallados y tarjetas visuales modernas.

Sin HACS, tendrías que descargar archivos de código manualmente, crear carpetas ocultas y reiniciar el sistema cruzando los dedos. HACS automatiza todo esto de forma segura. Descubre más sobre la evolución de este software libre en la página de Wikipedia sobre código abierto.

Requisitos Previos: Preparando el terreno de forma segura

Para instalar HACS en Home Assistant, necesitamos asegurarnos de que tienes dos cosas listas. No te preocupes, son muy sencillas.

1. Copia de seguridad (Tu red de seguridad)

Siempre que instalamos componentes de terceros, existe un pequeño riesgo. Como expertos en sistemas, te recomendamos encarecidamente hacer un respaldo. Si aún no tienes un sistema automático, revisa nuestra estrategia de backup 3-2-1 para Home Assistant. Hacer una copia completa ahora te llevará 2 minutos y te dará paz mental.

2. Una cuenta en GitHub (El almacén del código)

Todo el código de HACS está alojado en GitHub (la plataforma más grande de programadores del mundo). Home Assistant necesita conectarse allí para descargar las actualizaciones. Si no tienes cuenta, ve a GitHub y regístrate gratis. Es un paso obligatorio, ya que sin cuenta, los servidores bloquearán las descargas de tu servidor por «exceso de peticiones».

3. Acceso a la Terminal o SSH

Necesitas poder escribir un comando en tu servidor. La forma más fácil es instalar el complemento (Add-on) llamado Terminal & SSH o Advanced SSH & Web Terminal desde la tienda oficial de complementos de tu Home Assistant.

Nota sobre el hardware: Instalar muchas integraciones personalizadas puede consumir memoria RAM. Si usas una Raspberry Pi antigua y notas lentitud, plantéate revisar si necesitas hardware de servidor domótico más potente como un Mini PC.

Cómo Instalar HACS en Home Assistant (Paso a paso)

Vamos al núcleo del asunto. Sigue estos pasos exactamente en este orden. Está pensado para que cualquier persona, incluso sin conocimientos de programación, pueda lograrlo.

Paso 1: Ejecutar el script de instalación

  1. Abre tu Home Assistant en el navegador.
  2. Inicia el complemento Terminal que instalamos en los requisitos previos y abre la interfaz web (UI).
  3. Verás una pantalla negra con texto. Copia y pega exactamente este comando (es el comando oficial proporcionado por los creadores de HACS):

    wget -O - https://get.hacs.xyz | bash -

  4. Pulsa la tecla Enter. Verás cómo descarga unos archivos. Tardará apenas unos segundos. Cuando vuelva a aparecer el cursor parpadeando, la descarga ha terminado.

Captura de pantalla de la terminal de Home Assistant ejecutando el comando de instalación de HACS

Paso 2: Reiniciar tu servidor domótico

El sistema necesita «leer» los nuevos archivos que acabamos de descargar. Ve a Ajustes > Sistema y pulsa el botón de encendido arriba a la derecha para hacer un Reinicio completo. Ve a prepararte un café, esto tomará uno o dos minutos dependiendo de tu equipo.

Paso 3: Limpiar la caché del navegador

Este es el paso donde el 90% de los principiantes se atasca. Tras reiniciar, tu navegador (Chrome, Safari, etc.) sigue recordando la versión antigua de tu página. Debes limpiar la caché para que reconozca HACS.

  • En Windows: Pulsa Ctrl + F5.
  • En Mac: Pulsa Cmd + Shift + R.
  • Si usas la App del móvil: Fuerza el cierre de la aplicación o ve a los ajustes de la app y «Recargar Frontend».

Paso 4: Añadir la Integración y autorizar con GitHub

  1. Ve a Ajustes > Dispositivos y Servicios.
  2. Pulsa el botón azul abajo a la derecha: Añadir Integración.
  3. Busca la palabra HACS. Si no aparece, repite el Paso 3 (limpiar caché).
  4. Aparecerá una ventana con varias casillas de verificación. Son advertencias de seguridad que te recuerdan que HACS usa código de terceros. Márcadas todas con responsabilidad y pulsa Enviar.
  5. Se abrirá una ventana dándote un código de 8 letras y un enlace a GitHub.
  6. Haz clic en el enlace, inicia sesión en tu cuenta de GitHub, pega el código de 8 letras y autoriza a HACS.
  7. ¡Hecho! Aparecerá un mensaje de éxito. Vuelve a tu Home Assistant y verás que en el menú lateral izquierdo tienes un nuevo icono espectacular llamado HACS.

Navegando por HACS: El paraíso de las integraciones y el diseño

¡Enhorabuena! Acabas de multiplicar por cien las capacidades de tu hogar inteligente. Al entrar en la pestaña HACS en tu menú lateral, verás un panel muy intuitivo, dividido principalmente en dos grandes secciones.

Sección 1: Integraciones (Cerebros y Conexiones)

Aquí encontrarás las conexiones con hardware y servicios externos. ¿Compraste un electrodoméstico raro en internet? Probablemente su integración esté aquí. Al instalar una integración desde HACS, lo único que estás haciendo es descargar el código en tu carpeta custom_components. Importante: Tras instalar cualquier integración desde HACS, siempre debes reiniciar Home Assistant y luego ir a Ajustes > Dispositivos y Servicios para configurarla como una integración normal.

Sección 2: Frontend (Tarjetas, Temas y Estilos)

Esta es la sección favorita de los usuarios creativos. Aquí encontrarás elementos visuales para transformar tu panel de control.

Una recomendación brutal para empezar es buscar «Mushroom Cards». Son unas tarjetas minimalistas, elegantes y muy fáciles de configurar para personas con poco tiempo que quieren un diseño moderno de inmediato. Otra genial es la «Vacuum Card», ideal si has leído nuestra guía de robots aspiradores con mapa, ya que te permite controlar tu robot con un mapa interactivo directo en el panel.

Ejemplo de un panel de Home Assistant con un diseño moderno utilizando tarjetas Mushroom instaladas a través de HACS

Mantenimiento y Buenas Prácticas de Seguridad (E-E-A-T)

Como profesionales de la domótica, nuestra responsabilidad es no solo enseñarte a instalar cosas, sino a mantenerlas seguras a largo plazo. El software de terceros puede tener fallos, por lo que te damos estas pautas aplicables desde hoy mismo:

  • Mantén todo actualizado: HACS te avisará en la pantalla principal cuando haya actualizaciones de las tarjetas o integraciones que hayas descargado. Instálalas periódicamente, pero siempre lee las «Release Notes» (Notas de la versión) para asegurarte de que no hay cambios drásticos («Breaking Changes»).
  • Revisa los repositorios no oficiales con cautela: Cualquier usuario puede crear un repositorio personalizado en HACS. Fíjate en el número de estrellas de GitHub que tiene el proyecto. Si un proyecto tiene miles de descargas y estrellas, ha sido validado por la comunidad. Si es de un usuario desconocido y tiene 2 descargas, úsalo bajo tu propio riesgo.
  • No satures tu panel: Si no sabes cómo organizar tu Home Assistant con YAML, evita instalar 50 tarjetas de golpe. Instala solo lo que realmente vayas a usar para no ralentizar el tiempo de carga de la aplicación en tu móvil.

La seguridad de tu red doméstica comienza en tu servidor. Si te preocupan estos aspectos de conectividad y ciberseguridad, no está de más complementar tu red con un acceso remoto cifrado; puedes ver nuestra guía sobre Cloudflare Tunnel vs Nginx Proxy Manager.

🛒 Recomendación del Experto para Servidores Seguros: Si tu biblioteca de HACS empieza a crecer y tu vieja Raspberry Pi se bloquea, el estándar actual en la comunidad domótica es dar el salto a un Mini PC. Te recomendamos encarecidamente revisar opciones basadas en el procesador N100, que consumen la misma energía pero multiplican la potencia.

👉 Ver Mini PCs N100 recomendados para Home Assistant en Amazon

Preguntas Frecuentes (FAQ) sobre HACS

Sabemos que al principio el mundo de los repositorios y GitHub puede generar dudas. Hemos recopilado las 5 preguntas más frecuentes de nuestros lectores orientadas a solucionar problemas reales de manera rápida.

1. HACS no me aparece tras reiniciar, ¿qué hago mal?

El 99% de las veces es un problema de la caché del navegador. Limpia la caché presionando Ctrl + F5 (o Cmd + Shift + R en Mac). Si usas la app móvil, ciérrala del todo y vuelve a abrirla. Asegúrate también de que buscaste «HACS» pulsando el botón azul de «Añadir Integración» en la sección de Ajustes > Dispositivos.

2. ¿Es seguro instalar integraciones de terceros?

HACS en sí mismo es totalmente seguro y su código fuente abierto está auditado por miles de personas. Sin embargo, las integraciones individuales las hacen desarrolladores particulares. Usa el sentido común: descarga aquellas que están marcadas como «Default» en la tienda y que tienen un alto número de valoraciones en la comunidad.

3. ¿Qué diferencia hay entre un «Add-on» (Complemento) y una integración de HACS?

Es una confusión muy típica. Los Add-ons son aplicaciones completas que corren al lado de Home Assistant (como un servidor MQTT, Node-RED o una base de datos InfluxDB). HACS instala Integraciones y Frontend, que son fragmentos de código en Python o Javascript que funcionan dentro del propio entorno de Home Assistant para añadir compatibilidad a dispositivos o mejorar el diseño.

4. ¿Por qué me pide autenticación en GitHub? ¿Me van a cobrar?

No, GitHub es 100% gratuito. HACS utiliza la infraestructura (servidores) de GitHub para buscar e instalar actualizaciones de todos los componentes. Para evitar que las IPs de Home Assistant saturen sus servidores, GitHub requiere que haya un usuario identificado realizando esas peticiones. Por eso es vital vincular tu cuenta personal.

5. He instalado una tarjeta frontend, pero mi Lovelace me da error de que no existe.

Cuando instalas una tarjeta en HACS (por ejemplo, una «Mushroom Card»), a veces Home Assistant necesita un pequeño empujón para cargar el código de Javascript. Ve al menú superior derecho de tu panel, dale a «Editar panel», haz clic en los tres puntos y selecciona «Recargar recursos». También recargar la pestaña del navegador suele solucionar este fallo de inmediato.

El Siguiente Nivel de tu Hogar Inteligente

Instalar HACS en Home Assistant no es solo un trámite técnico; es abrir la puerta a la personalización absoluta. Atrás quedan los días en los que tu panel domótico lucía como una aburrida lista de interruptores de texto. Ahora tienes las herramientas para que tu casa responda y se vea exactamente como tú quieres, adaptándose a tu estilo de vida acelerado.

Desde tener gráficas preciosas del clima, hasta botones elegantes que consolidan todo el control de una habitación en un solo vistazo. Todo está a tres clics de distancia gracias a la increíble comunidad que hay detrás de este proyecto.

Motívate a la acción: Hoy has aprendido a instalar HACS y comprender su estructura. No lo dejes aquí. Tu siguiente paso natural es explorar la sección de «Frontend» y descargar un paquete de tarjetas visuales. Te invitamos a leer nuestra guía sobre cómo instalar una tablet en la pared para domótica, porque con tu nuevo HACS, vas a querer lucir tu panel de control como si fuera una obra de arte en tu salón. ¡Comienza a diseñar la casa del futuro hoy mismo!

¿Te ha sido útil? ¡Compártelo con otros!

Únete a la Comunidad

Síguenos en nuestras redes para ver tutoriales en vídeo, ideas de decoración y trucos rápidos para tu hogar inteligente.