Cosmic-light

Che cos'è Cosmic-light?

Cosmic-light è un control center per Windows “Dynamic Island” che integra stato rapido, controlli media, meteo visivo, eventi calendario e interfaccia chat AI in un'unica UI sullo schermo. L'interfaccia si espande da un elemento “isola” posizionato sul desktop ed è progettata per mostrare informazioni rilevanti quando servono.

Il progetto è realizzato come app local-first: usa storage locale per il contesto delle conversazioni e crittografa le chiavi API aggiunte per le feature AI. Include anche script Python system-bridge per accedere a dati come media e meteo.

Caratteristiche Principali

• UI Dynamic Island (Basso o Centro): Posiziona l'isola sullo schermo e la espande in modo intelligente quando interagisci.
• Vista home rapido: Mostra ora, data e stato della finestra attiva.
• Controllo media e integrazione Spotify/audio di sistema: Offre play/pausa/avanti/indietro e controllo volume, con visualizzatore audio real-time e metadati traccia (incluso artwork album e progressione).
• Icone media smart: Rileva sorgente input (es. Spotify, YouTube, Chrome) e dispositivo output (es. cuffie, altoparlanti).
• Visualizzazione meteo live: Renderizza effetti particelle real-time (pioggia, neve, nuvole, stelle) e mostra statistiche come temperatura, vento, umidità e probabilità precipitazioni, con avvisi meteo severi in stile alert.
• Calendario smart con sync Google Calendar: Usa indirizzo iCal segreto per sincronizzare eventi, espande automaticamente l'isola 5 minuti prima di un evento e include vista mese interattiva.
• Chat AI (local-first): Include interfaccia chat integrata con “Gemini Mode” (Google Gemini) e “Perplexity Mode” (ricerca web con citazioni/fonti). La cronologia conversazioni è salvata localmente.
• Chiavi API crittografate: Crittografa le chiavi API aggiunte nelle impostazioni per maggiore sicurezza.

Come Usare Cosmic-light

1. Installa prerequisiti: Usa Node.js v20+ e Python v3.10+.
2. Configura il progetto:
   • Clona il repository.
   • Installa dipendenze frontend con npm install.
   • Installa dipendenze backend con pip install -r requirements.txt.
3. Avvia localmente: Lancia l'app con npm run dev.
4. Apri e configura:
   • Clicca sulla Dynamic Island per espanderla.
   • Usa Settings (icona ingranaggio) per configurare AI API keys (Gemini e/o Perplexity) e sync Google Calendar.
5. (Opzionale) Crea installer: Per un .exe Windows standalone, esegui npm run build; l'installer va in release/.

Casi d'Uso

• Controllo desktop media-first: Gestisci riproduzione e volume dall'isola visualizzando metadati traccia e visualizzatore audio real-time, senza passare a finestra media separata.
• Contesto rapido multitasking: Controlla velocemente ora/data e app attiva dalla vista home dell'isola.
• Consapevolezza meteo con cue visivi: Monitora condizioni meteo variabili tramite particelle animate e leggi statistiche chiave come vento e umidità, inclusi avvisi meteo severi.
• Promemoria calendario per riunioni imminenti: Sincronizza Google Calendar privato via indirizzo iCal segreto dell'app e affidati all'espansione automatica dell'isola 5 minuti prima degli eventi.
• Assistenza risposta/ricerca in UI desktop: Usa modalità chat Gemini o Perplexity dall'isola; salva chiavi API nelle impostazioni e mantieni cronologia conversazioni localmente.

FAQ

• Cosa serve per eseguire Cosmic-light? Node.js v20 o superiore è richiesto per l'app, e Python v3.10 o superiore per gli script system bridge.

• Come abilito le feature chat AI? Apri le impostazioni app e aggiungi la tua Gemini API Key e/o Perplexity API Key. Il progetto nota che almeno una deve essere abilitata.

• Come funziona il sync Google Calendar? Nelle impostazioni Google Calendar, genera o copia un “iCal secret address” (formato iCal) e incollalo in Settings > Google Calendar dell'app.

• Dove sono salvati i dati? Il progetto adotta approccio local-first: cronologia conversazioni salvata localmente, chiavi API nelle impostazioni crittografate.

• Posso posizionare l'isola diversamente? Sì. Le impostazioni includono opzioni posizionamento per l'isola in Basso o Centro dello schermo, e supporta selezione monitor di visualizzazione.

Alternative

• Framework widget a livello di OS: Invece di un’interfaccia espandibile in stile Dynamic Island, usa sistemi desktop per widget/launcher che aggregano widget (meteo, calendario, media) a schermo; i workflow differiscono perché il comportamento di espansione e la presentazione “island” potrebbero non essere integrati.
• App controller media: Strumenti dedicati al controllo media possono offrire comandi di riproduzione e volume più visualizzazioni, ma potrebbero non includere lo stesso layout combinato meteo/calendario/AI.
• Integrazioni desktop calendario + meteo: Integrazioni standalone per calendario e meteo si concentrano su quelle fonti dati specifiche; tipicamente non raggruppano l’interfaccia chat AI e il pattern di espansione Dynamic Island in un unico control center.
• Applicazioni chatbot locali: Client chat generici o frontend AI locali possono sostituire il pannello AI dell’island, ma perderesti il contesto UI integrato calendario/media/meteo dell’island.