Cosmic-light

¿Qué es Cosmic-light?

Cosmic-light es un centro de control tipo “Dynamic Island” en Windows que muestra información de un vistazo, controles de medios, visuales del clima, eventos del calendario y una interfaz de chat con IA en una sola UI en pantalla. La interfaz se expande desde un elemento “island” posicionado en el escritorio, y está diseñada para mostrar información relevante cuando la necesitas.

El proyecto está construido como una aplicación local-first: usa almacenamiento local para el contexto de conversaciones y cifra las claves API agregadas para funciones de IA. También incluye scripts Python de system-bridge para acceder a datos como medios y clima.

Características principales

• UI Dynamic Island (Abajo o Centro): Coloca la isla en tu pantalla y se expande de forma inteligente al interactuar con ella.
• Vista principal de un vistazo: Muestra hora, fecha y el estado de la ventana activa actual.
• Control de medios e integración con Spotify/audio del sistema: Ofrece play/pausa/siguiente/anterior y control de volumen, junto con un visualizador de audio en tiempo real y metadatos de pista (incluyendo carátula y progreso).
• Iconos de medios inteligentes: Detecta la fuente de entrada (p. ej., Spotify, YouTube, Chrome) y el dispositivo de salida (p. ej., auriculares, altavoces).
• Visualización del clima en vivo: Renderiza efectos de partículas en tiempo real (lluvia, nieve, nubes, estrellas) y muestra estadísticas como temperatura, viento, humedad y probabilidad de precipitación, con alertas de clima severo.
• Calendario inteligente con sincronización de Google Calendar: Usa una dirección secreta iCal para sincronizar eventos, expande automáticamente la isla 5 minutos antes de que comience un evento e incluye una vista interactiva del mes.
• Chat con IA (local first): Incluye una interfaz de chat integrada con “Gemini Mode” (Google Gemini) y “Perplexity Mode” (búsqueda web con citas/fuentes). El historial de conversaciones se almacena localmente.
• Claves API cifradas: Cifra las claves API agregadas en ajustes para mejorar la seguridad.

Cómo usar Cosmic-light

1. Instala los requisitos previos: Usa Node.js v20+ y Python v3.10+.
2. Configura el proyecto:
   • Clona el repositorio.
   • Instala dependencias del frontend con npm install.
   • Instala dependencias del backend con pip install -r requirements.txt.
3. Ejecuta localmente: Inicia la app con npm run dev.
4. Abre y configura:
   • Haz clic en la Dynamic Island para expandirla.
   • Usa Settings (icono de engranaje) para configurar AI API keys (Gemini y/o Perplexity) y sincronización de Google Calendar.
5. (Opcional) Crea un instalador: Para un .exe independiente de Windows, ejecuta npm run build; el instalador se coloca en el directorio release/.

Casos de uso

• Control de escritorio centrado en medios: Controla reproducción y volumen desde la isla mientras ves metadatos de pista y un visualizador de audio en tiempo real, sin cambiar a una ventana de medios separada.
• Contexto de un vistazo multitarea: Verifica rápidamente hora/fecha y qué aplicación está activa desde la vista principal de la isla.
• Conciencia del clima con indicios visuales: Monitorea condiciones climáticas cambiantes mediante partículas animadas y lee estadísticas clave como viento y humedad, incluidas alertas de clima severo.
• Recordatorios de calendario para reuniones próximas: Sincroniza un Google Calendar privado mediante la dirección secreta iCal de la app y confía en que la isla se expanda automáticamente 5 minutos antes de los eventos.
• Asistencia de respuesta/búsqueda en la UI de escritorio: Usa modos de chat Gemini o Perplexity desde la isla; almacena claves API en ajustes y guarda el historial de conversaciones localmente.

Preguntas frecuentes

• ¿Qué necesito para ejecutar Cosmic-light? Se requiere Node.js v20 o superior para la app, y Python v3.10 o superior para los scripts de system bridge.

• ¿Cómo activo las funciones de chat con IA? Abre los ajustes de la app y agrega tu Gemini API Key y/o Perplexity API Key. El proyecto indica que al menos una debe estar habilitada.

• ¿Cómo funciona la sincronización de Google Calendar? En los ajustes de Google Calendar, genera o copia una “iCal secret address” (en formato iCal) y pégala en Settings > Google Calendar de la app.

• ¿Dónde se almacena los datos? El proyecto describe un enfoque local-first: el historial de conversaciones se almacena localmente, y las claves API agregadas en ajustes están cifradas.

• ¿Puedo posicionar la isla de forma diferente? Sí. Los ajustes incluyen opciones de posicionamiento para colocar la isla en la parte inferior o centro de tu pantalla, y permite seleccionar en qué monitor aparece.

Alternativas

• Frameworks de widgets a nivel de SO: En lugar de una IU expansible tipo Dynamic Island, usa sistemas de widgets/launchers de escritorio que agregan widgets (clima, calendario, medios) en pantalla; los flujos de trabajo difieren porque el comportamiento de expansión y la presentación tipo “island” podrían no estar integrados.
• Apps de control de medios: Herramientas dedicadas de control de medios pueden ofrecer controles de reproducción y volumen más visualizaciones, pero podrían no incluir el mismo diseño combinado de clima/calendario/IA.
• Integraciones de escritorio para calendario + clima: Integraciones independientes de calendario y clima se centran en esas fuentes de datos específicas; normalmente no agrupan la interfaz de chat con IA y el patrón de expansión tipo Dynamic Island en un solo centro de control.
• Aplicaciones de chatbots locales: Clientes de chat generales o frontends de IA locales pueden reemplazar el panel de IA de la isla, pero perderías el contexto de IU integrado de calendario/medios/clima de la isla.