Home Assistant puede generar un paquete de diagnóstico de Argus con conteos de entidades y estado básico de TTS. Los datos se agregan sin incluir IDs de entidades, PIN, entidad TTS ni nombres de reproductores.
Sistema Integral de Seguridad Residencial Inteligente, Local y Profesional para Home Assistant
- Añade un diagnóstico descargable con conteos agregados y estado básico de TTS, sin exponer IDs de entidades, PIN, destinos ni nombres de reproductores.
- Mantiene la lógica de armado y las reglas de acceso existentes; incluye compatibilidad comprobada con Home Assistant Core 2026.10.
🌟 ¡Apoya el desarrollo de Argus!
• ⭐ Dale una estrella en GitHub: https://github.com/Chrisalvir1/Argus
• ☕ Apoya en PayPal: https://paypal.me/CEstradaAlvir
• ✉️ Correo para sugerencias y soporte: [email protected]
Argus Home Hub es un centro de seguridad residencial avanzado, local e independiente para Home Assistant, diseñado para proteger tu hogar con total privacidad, sin suscripciones mensuales y sin depender de servicios externos en la nube.
Construido sobre una arquitectura ultra-ligera de última generación con TypeScript 7 + Vite 8.3 + React 19.3 + react-grid-layout 2.2, Argus combina una estética cinematográfica de Liquid Glass (Cristal Líquido) con un motor de seguridad de grado profesional, compatibilidad nativa con HomeKit, asistente de voz interactivo (TTS), notificaciones móviles inteligentes y un Nuevo Modo de Alto Contraste / Modo Oscuro OLED enfocado en máxima accesibilidad visual.
- Tecnología de Vanguardia: Impulsado por React 19.3.0, Vite 8.3.2 (Rolldown engine), react-grid-layout 2.2.4, react-resizable 4.0.2, Vitest 5.0.3, TypeScript 7.0.2 y Nanoid 6.0.1.
- Activos de Marca Oficiales (HA 2026.3+): Cumplimiento total con el nuevo Brands Proxy API de Home Assistant, sirviendo localmente los iconos y logos oficiales en alta resolución.
- Transición Líquida (iOS/macOS Fluid Spring): Selector de Modos / SOS con física de resorte elástico, gradientes multicapa y deslizamiento continuo de cristal líquido.
- 50% Más Ligero: Reducción drástica a la mitad de los paquetes en desarrollo (de 118 a 59 dependencias, eliminando 67 módulos heredados obsoletos de Babel).
- Velocidad Extrema: Compilación del bundle en ~120 ms (5x más rápido) y suite de pruebas de frontend en ~140 ms.
- Zero-Bloat y Cero Vulnerabilidades: 0 dependencias externas de pip en Python (100% nativo y local en Home Assistant) y 0 vulnerabilidades de seguridad auditadas en producción.
- Transparencia en Ejecución: El servidor de Home Assistant corre 100% en Python nativo (compatible con Python 3.12, 3.13 y 3.14). El usuario final NO necesita tener instalado Node.js en su servidor ni en su Raspberry Pi.
Important
Aviso de Responsabilidad: Argus es un sistema de automatización y seguridad residencial local de código abierto para Home Assistant. No sustituye una central receptora de alarmas certificada ni garantiza conexión directa con servicios de policía o bomberos. Asegúrate de probar periódicamente sensores, sirenas, avisos sonoros y respaldos.
- 4 Estados de Protección: Desarmado, En Casa (Arm Home), Fuera de Casa (Arm Away) y Noche (Arm Night).
- Tiempos de Gracia Configurables: Retardos independientes de salida y entrada por cada modo para evitar falsas alarmas al entrar o salir.
- Disparo Instantáneo: Modo de intrusión con activación configurable de sirenas internas, externas, luces parpadeantes y scripts de emergencia.
- Detección Activa de Sensores Abiertos: Al intentar armar, Argus comprueba inmediatamente todas las puertas, ventanas y sensores vinculados. Si alguno está abierto, lo notifica en pantalla y por voz (TTS) y te permite cerrarlo o aplicar Bypass (Omitir) de forma individual con un solo toque.
- Activación Directa en el Perfil: Alterna fácilmente entre el aspecto estándar Liquid Glass y el tema Alto Contraste.
- Diseñado para la Legibilidad y Pantallas OLED: Fondos profundos con negros puros, textos de máximo contraste (blanco nítido y gris claro), bordes definidos y eliminación de transparencias reflectantes para una lectura cómoda bajo luz solar o en habitaciones oscuras.
- Soporte de Sistema Operativo: Respeta automáticamente la preferencia de accesibilidad
@media (prefers-contrast: more).
- Seguro contra Toques Accidentales: Sustituye botones convencionales por controles deslizantes táctiles fluidos tipo "Deslizar para desarmar" o "Deslizar para activar SOS", inspirados en el diseño de iOS.
- Protección para Niños y Mascotas: Impide desarmes o alertas de pánico involuntarias causadas por roces en tablets de pared o pantallas táctiles.
- Widgets Arrastrables y Redimensionables: Basado en
react-grid-layout, organiza tus tarjetas de seguridad, historial, automatizaciones y control de acceso a tu gusto con tamaños inteligentes (S, M, L, XL). - Persistencia por Dispositivo: El diseño y la distribución de widgets se memorizan localmente según el tamaño de la pantalla (teléfono, tablet de pared, monitor de escritorio o pantalla en formato Kiosk).
- Anuncios por Altavoces en Vivo: Notificaciones habladas automáticas a través de cualquier reproductor multimedia (
media_player) de Home Assistant. - Información Precisa: Si una puerta impide el armado, Argus te dirá exactamente: "No se puede armar. La puerta principal está abierta". También anuncia cuentas regresivas de salida y alarmas activadas.
- Separación Rigurosa de Credenciales:
- Pin de Armado (Master PIN): Controla exclusivamente el armado, desarmado y cancelación del pánico de las instancias de alarma.
- Pin de Perfil (Access PIN): Protege la apertura del panel Argus y el cambio de usuarios.
- Cifrado Seguro: Hashing de contraseñas mediante algoritmos criptográficos locales (
scrypt/ PBKDF2), protegiendo tus claves de cualquier fuga en el frontend. - Gestión Multi-Usuario con Permisos Granulares: Asigna roles (Administrador o Usuario Estándar) y permisos específicos (Ver estado, Armar, Desarmar, Ver historial, Gestionar pines) con insignia visual de estado.
- Activación Rápida y Segura: Activación manual protegida por confirmación o deslizador táctil.
- Dispositivos de Auxilio Automáticos: Dispara automáticamente sirenas, luces de advertencia y rutinas preconfiguradas, incluso con el sistema desarmado.
- Teléfono de Emergencias Local: Botón de llamada rápida configurable según tu país o región (911, 112, etc.).
- Detención Reversible: Permite cancelar el pánico restaurando el sistema exactamente al estado de seguridad anterior.
Argus se integra de forma directa y nativa con la aplicación Home Assistant Companion para alertarte de cualquier evento de seguridad en tu móvil:
- Alertas Críticas de Máxima Prioridad: Notificaciones push de emergencia con sonido de sirena estridente que ignoran automáticamente el modo silencioso o No Molestar del dispositivo.
- Acciones Rápidas desde el Mensaje: Botones interactivos directamente en la notificación (Desarmar, Ver Cámaras, Silenciar Sirena, Activar Luces) para actuar de inmediato sin perder tiempo abriendo la aplicación.
- Exportación e Importación Completa: Descarga y restaura perfiles, sensores, configuraciones de modos y ajustes de seguridad en archivos protegidos con cifrado AES-GCM.
- Recuperación en el Asistente Inicial: En instalaciones nuevas o migraciones, puedes subir tu archivo de respaldo directamente en la pantalla de bienvenida.
- Usa Argus en cualquier panel de Home Assistant mediante las tarjetas personalizadas
custom:argus-cardocustom:argus-panel-card. - Soporte para pantalla completa sin marcos (ideal para tablets táctiles de pared).
Argus Home Hub forma parte del catálogo oficial por defecto de HACS, por lo que su instalación es directa y sin configuraciones manuales de repositorios:
- Abre HACS en el menú lateral de tu Home Assistant.
- Ve a la sección Integraciones.
- En el buscador superior escribe Argus (o Argus Home Hub).
- Selecciona la integración y haz clic en Descargar.
- Reinicia Home Assistant.
- Ve a Ajustes → Dispositivos y servicios → Añadir integración y selecciona Argus Home Hub.
Si por temas de caché tu catálogo local de HACS no muestra la integración en la búsqueda:
- En HACS → Integraciones, toca el menú de tres puntos (⋮) en la esquina superior derecha y selecciona Repositorios personalizados.
- Añade
https://github.com/Chrisalvir1/Arguscon la categoría Integración. - Haz clic en Añadir y luego en Descargar.
- Reinicia Home Assistant y añade la integración desde Ajustes.
- Descarga el archivo
argus.zipde la última versión en Releases. - Descomprime el contenido dentro de la carpeta
custom_components/argus/de tu instalación:/config/custom_components/argus/ - Reinicia Home Assistant.
- Añade la integración desde Ajustes → Dispositivos y servicios.
Para que Argus hable a través de los altavoces de tu hogar anunciando cambios de estado y sensores abiertos, añade lo siguiente en tu archivo configuration.yaml de Home Assistant:
argus:
arming_voice:
media_player: media_player.altavoces_salon
tts_service: tts.google_translate_sayEl idioma de las locuciones se sincronizará automáticamente con el idioma que tengas configurado en el panel de Argus (Español o Inglés).
Para añadir la tarjeta de alarma de Argus a cualquier vista de tu Dashboard en Home Assistant:
type: custom:argus-card
entity: alarm_control_panel.argus
title: Seguridad del HogarO si prefieres incrustar el panel completo de Argus con todas sus herramientas:
type: custom:argus-panel-cardArgus cuenta con una suite completa de pruebas unitarias y verificación de contratos:
# Compilar el frontend en React 19
npm install
npm run build
# Ejecutar pruebas unitarias de frontend
npm test
# Ejecutar suite de pruebas unitarias de backend Python
python3 -m unittest discover tests¡La comunidad hace que Argus siga creciendo! Si tienes ideas, comentarios, encuentras un fallo o deseas colaborar:
| Canal | Enlace / Detalle |
|---|---|
| ✉️ Correo de Sugerencias & Contacto | [email protected] |
| ⭐ Repositorio en GitHub | https://github.com/Chrisalvir1/Argus |
| ☕ Donaciones y Apoyo en PayPal | https://paypal.me/CEstradaAlvir |
| 🐛 Reportar Errores o Solicitar Funciones | GitHub Issues |
| @cea1410 | |
| @chrisalvir1 |
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más información.