cindralux
Dashboard auto-alojado para Raspberry Pi con frontend Next.js/React y backend Node.js/Express. Integra calendario Google (iCal/API), clima Open-Meteo, gestión de basura, Home Assistant y asistente IA local. Sin Docker, corre en puertos 4000/5173, requiere TypeScript y Vite.
Ficha actualizada 28 sept 2026, 8:14 · upstream 28 sept 2026, 8:03 · release sin release detectada
Qué es cindralux
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Cindralux es un centro de comando doméstico auto-alojado diseñado para funcionar como kiosco en Raspberry Pi con Chromium. Ofrece widgets de calendario (Google iCal/API), clima (Open-Meteo sin clave), recogida de basura (reglas o ICS), control Home Assistant y asistente IA local (OpenAI-compatible). Incluye modo noche con campo estelar, temporizadores locales y slideshow de fotos.
El proyecto usa arquitectura monorepo con workspaces: frontend en Vite/React 18 + Tailwind, backend en Express/TypeScript sin build. Configuración centralizada en data/config.json (gitignored por seguridad) o variables de entorno. Soporta temas, presets de layout y datos demo para pruebas inmediatas.
Integraciones clave: calendario Google (API o iCal), Home Assistant (REST API), OpenAI (clave opcional), clima sin API key. Todo es local; nada se envía a la nube salvo servicios externos configurados explícitamente. Ideal para familias que quieren evitar suscripciones y mantener control total.
- Centro de mando familiar en sala con calendario compartido, clima y tareas domésticas
- Kiosco educativo o informativo en espacios públicos con modo kiosk y datos locales
- Panel domótico unificado para controlar Home Assistant y mostrar sensores en tiempo real
- Asistente IA local para consultas sobre eventos, clima o basura sin enviar datos a la nube
- Sin dependencias de nube obligatorias; todo configurable localmente con credenciales en data/config.json
- Integración nativa con Home Assistant vía REST API y sensores locales (temperatura, humedad)
- Asistente IA que responde con datos reales del sistema (calendario, clima, basura) sin clave opcional
- Modo kiosk estable en Raspberry Pi con Chromium; no requiere Docker ni contenedores
- Datos demo incluidos para pruebas inmediatas sin configuración inicial
- Desarrollo activo: estructura/API pueden cambiar frecuentemente según roadmap
- Sin Dockerfile nativo; despliegue manual con npm start o systemd en Pi
- Modo voz requiere clave OpenAI con crédito (ChatGPT Plus no habilita WebRTC Realtime)
- Calendario Google vía API necesita proyecto Cloud y OAuth one-time (~10 min)
- Puerto 4000 debe exponerse solo a red local o mediante proxy HTTPS autenticado
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega en Raspberry Pi 4/5 con systemd. Usa npm start para modo producción (un proceso, puerto 4000). Guarda secretos en data/config.json o variables de entorno (.env). No expongas puerto 4000 directamente a internet; usa SSH tunnel o proxy HTTPS autenticado. Verifica permisos de lectura en assets/ y data/. Reinicia servicio tras cambios en config.json.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.