Conectar el hub con Home Assistant

Si en casa tenéis Home Assistant, puedes traer a él lo que llevas en el hub: la lista de la compra, las tareas, los recordatorios, los gastos y el menú del día. Cada persona conecta su propia cuenta y ve lo mismo que en la app.

Qué necesitas

Home Assistant 2026.9 o posterior.
HACS instalado. Si no lo usas, se puede instalar a mano (más abajo).
Una cuenta en el hub.

1. Instalar la integración

En Home Assistant, abre HACS, pulsa el menú ⋮ de arriba a la derecha y elige Repositorios personalizados.
En «Repositorio» escribe https://github.com/ElPostilla/ha-compra-hub. En «Tipo», elige Integración. Pulsa «Añadir».
Busca Compra Hub (raspimc) en HACS, ábrelo y pulsa Descargar.
Reinicia Home Assistant.

Sin HACS: descarga el repositorio, copia la carpeta custom_components/compra_hub dentro de la carpeta custom_components de tu configuración de Home Assistant y reinicia.

2. Conectar tu cuenta

Ve a Ajustes → Dispositivos y servicios → Añadir integración y busca «Compra Hub».
Deja el hub en compra.raspimc.org y pulsa «Enviar».
Se abre la página de inicio de sesión del hub. Entra con tu usuario y contraseña de siempre.
Al volver pasas por my.home-assistant.io. La primera vez te pregunta la dirección de tu Home Assistant (por ejemplo, http://homeassistant.local:8123). Escríbela y continúa.

Listo. No hay que crear claves ni copiar códigos, y no tendrás que volver a entrar cada día: Home Assistant renueva la sesión él solo. Si algún día la cierras desde tu cuenta, Home Assistant te pedirá iniciar sesión otra vez.

3. Qué aparece

Compra: tu lista de la compra, como lista de tareas de Home Assistant. Puedes añadir, tachar, cambiar el nombre o la cantidad (va en la descripción) y borrar. Si tienes varias listas personales, cada una sale con su nombre.
Compra ‹grupo›: la lista de cada grupo al que perteneces.
Tareas y Tareas ‹grupo›: añadir, completar, poner fecha y borrar.
Calendario y Calendario ‹grupo›: tus recordatorios, también los que se repiten. Se ven, pero no se crean desde aquí.
Gastos Este mes: lo que llevas gastado este mes.
Gastos Saldo ‹grupo›: lo que te deben (positivo) o debes (negativo) en cada grupo.
Menú Comida de hoy y Menú Cena de hoy: lo que está planificado.

Todo se actualiza cada minuto. Lo que cambias desde Home Assistant se ve en la app al momento. Si entras en un grupo nuevo, sus listas aparecen solas.

«Eliminar completados» se porta igual que «Vaciar comprados» en la app: los productos fijos (📌) no se borran, se desmarcan para la próxima compra.

4. El hub dentro de Home Assistant

En la barra lateral aparece Compra Hub, con la app completa dentro. La primera vez inicias sesión dentro del panel con tu cuenta del hub. Arriba a la derecha está siempre Abrir en una ventana.

Por seguridad, el hub solo se deja mostrar dentro de páginas que tiene permitidas, y los navegadores (sobre todo el del iPhone) no comparten la sesión con páginas de otro dominio. Si en tu Home Assistant el panel sale en blanco o te pide entrar una y otra vez, usa Abrir en una ventana: abre el hub aparte, en la app del móvil en su navegador integrado. Si no quieres el panel, quítalo en Ajustes → Dispositivos y servicios → Compra Hub → Configurar.

5. Con la voz

Con el asistente de voz de Home Assistant (Assist) funcionan frases como:

«Añade leche a la lista compra»
«Añade sal a la lista compra casa», para la lista del grupo «Casa»
«Añade llamar al banco a la lista de tareas»
«Quita leche de la lista compra»

Un detalle: «…a la lista de la compra» va a la lista de la compra propia de Home Assistant, que viene activada de serie, porque esa frase la tiene reservada. Si no usas esa lista, quítala en Ajustes → Dispositivos y servicios → Lista de la compra → Eliminar y la frase llegará a la del hub.

Ideas para automatizaciones

Un aviso cuando llegues al súper si la lista «Compra» tiene algo pendiente.
Encender una luz roja en la entrada si tu saldo en el grupo de casa baja de −50 €.
Que el altavoz de la cocina diga a las 13:00 qué toca comer.

Si algo no va

«Invalid state» al volver del inicio de sesión: my.home-assistant.io tiene apuntada otra dirección de Home Assistant. Ábrelo, pulsa en cambiar la dirección y vuelve a empezar.
Las entidades salen «No disponible»: comprueba que Home Assistant tiene internet. Si te pide volver a iniciar sesión, hazlo desde el aviso de Ajustes.

La integración solo habla con compra.raspimc.org y con su servidor de inicio de sesión. No manda nada a terceros. Más detalles en el artículo sobre cómo está hecha.