Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

homelable-hacs

Integración Home Assistant para visualizar topología de red homelab interactiva con escaneo en Python puro, sin Docker ni binarios externos.

Ficha actualizada 18 sept 2026, 21:29 · upstream 30 ago 2026, 23:49 · release v1.3.0

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es homelable-hacs

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Homelable-hacs es una integración personalizada para HACS que permite visualizar y monitorizar la topología de red de un homelab directamente dentro de Home Assistant. Proporciona paneles interactivos tipo Lovelace con capacidades de arrastrar, soltar y conectar nodos, además de soporte para importar inventarios de Zigbee, Z-Wave y Proxmox.

La integración utiliza un escáner puramente en Python que funciona sin binarios externos, empleando ping, ARP cache, TCP connect y mDNS. Soporta múltiples rangos de red configurables mediante CIDR y permite exportar mapas en formatos PNG/SVG. La configuración es completamente guiada a través de la interfaz de usuario.

Requiere Home Assistant 2024.1 o superior. Funciona en entornos HAOS, Supervised y Core, aunque el rendimiento del escáner puede variar según los permisos de red disponibles.

CASOS DE USO
  • Visualización interactiva de topología de red homelab en paneles Lovelace con arrastrar, soltar y conectar nodos
  • Monitorización en tiempo real del estado de dispositivos (online/offline) integrada en el dashboard
  • Importación e integración de inventarios de hardware como Zigbee, Z-Wave y Proxmox
  • Escaneo automático de rangos de IP configurables para descubrimiento de nuevos nodos en la red
  • Exportación de mapas de red en formatos PNG/SVG para documentación técnica
PUNTOS DESTACADOS
  • Integración nativa sin necesidad de contenedores Docker o binarios externos adicionales
  • Escáner puramente en Python con soporte para ping, ARP, TCP y mDNS sin root
  • Configuración completamente guiada vía UI con opciones personalizables de rangos y intervalos
  • Soporte multiplataforma: HAOS, Supervised y Core con adaptaciones de permisos automáticas
  • Licencia MIT abierta y compatible con repositorios HACS Custom
PRECAUCIONES
  • Requiere permisos CAP_NET_RAW para escaneo completo de ARP/ping en entornos contenedorizados
  • Solo permite un canvas por vista de dashboard; múltiples vistas necesarias para más paneles
  • Sin guardado automático del estado del canvas; requiere acción explícita para guardar
  • Escaneo TCP más lento y con menos detalle (sin MAC) si no se habilitan sockets crudos
  • La rueda del ratón en dashboard scrolla la vista en lugar de hacer zoom al canvas
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU1 vCPUrecomendación inicial
MEMORIA1 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Instalar vía HACS o manualmente copiando custom_components/homelable/. Configurar rangos CIDR para escaneo. En contenedores, añadir CAP_NET_RAW al launcher. Usar panel Lovelace para edición y card para visualización read-only.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.