Cosmic-light

O que é Cosmic-light?

Cosmic-light é um centro de controles “Dynamic Island” no Windows que reúne status de um olhar, controles de mídia, visualizações do clima, eventos do calendário e uma interface de chat de IA em um único UI na tela. A interface se expande a partir de um elemento “ilha” posicionado na área de trabalho e é projetada para exibir informações relevantes quando você precisa.

O projeto é construído como um aplicativo local-first: usa armazenamento local para o contexto de conversas e criptografa chaves de API adicionadas para recursos de IA. Também inclui scripts Python system-bridge para acessar dados como mídia e clima.

Principais Recursos

• UI Dynamic Island (Inferior ou Central): Posiciona a ilha na tela e a expande inteligentemente ao interagir.
• Visão inicial de um olhar: Mostra hora, data e status da janela ativa.
• Controle de mídia e integração Spotify/áudio do sistema: Oferece play/pause/próxima/anterior e controle de volume, com visualizador de áudio em tempo real e metadados da faixa (incluindo capa do álbum e progresso).
• Ícones de mídia inteligentes: Detecta a fonte de entrada (ex.: Spotify, YouTube, Chrome) e o dispositivo de saída (ex.: fones, alto-falantes).
• Visualização de clima ao vivo: Renderiza efeitos de partículas em tempo real (chuva, neve, nuvens, estrelas) e exibe estatísticas como temperatura, vento, umidade e chance de precipitação, com alertas de clima severo.
• Calendário inteligente com sincronização Google Calendar: Usa endereço secreto iCal para sincronizar eventos, expande a ilha automaticamente 5 minutos antes do início de um evento e inclui visão interativa mensal.
• Chat de IA (local first): Inclui interface de chat integrada com “Gemini Mode” (Google Gemini) e “Perplexity Mode” (busca web com citações/fontes). Histórico de conversas é armazenado localmente.
• Chaves de API criptografadas: Criptografa chaves de API adicionadas nas configurações para maior segurança.

Como Usar o Cosmic-light

1. Instale os pré-requisitos: Use Node.js v20+ e Python v3.10+.
2. Configure o projeto:
   • Clone o repositório.
   • Instale dependências frontend com npm install.
   • Instale dependências backend com pip install -r requirements.txt.
3. Execute localmente: Inicie o app com npm run dev.
4. Abra e configure:
   • Clique na Dynamic Island para expandi-la.
   • Use as Configurações (ícone de engrenagem) para configurar chaves de API de IA (Gemini e/ou Perplexity) e sincronização Google Calendar.
5. (Opcional) Crie um instalador: Para um .exe standalone do Windows, execute npm run build; o instalador fica na pasta release/.

Casos de Uso

• Controle de desktop focado em mídia: Controle reprodução e volume pela ilha enquanto vê metadados da faixa e visualizador de áudio em tempo real, sem alternar para janela de mídia separada.
• Contexto de um olhar no multitarefa: Verifique rapidamente hora/data e app ativo pela visão inicial da ilha.
• Acompanhamento do clima com pistas visuais: Monitore condições climáticas via partículas animadas e leia stats chave como vento e umidade, incluindo alertas de clima severo.
• Lembretes de calendário para reuniões próximas: Sincronize um Google Calendar privado via endereço secreto iCal do app e conte com a ilha expandindo automaticamente 5 minutos antes dos eventos.
• Assistência de resposta/busca no UI do desktop: Use modos de chat Gemini ou Perplexity pela ilha; armazene chaves de API nas configurações e mantenha histórico de conversas localmente.

FAQ

• O que preciso para rodar o Cosmic-light? Node.js v20 ou superior é necessário para o app, e Python v3.10 ou superior para os scripts system bridge.

• Como ativar os recursos de chat de IA? Abra as configurações do app e adicione sua Gemini API Key e/ou Perplexity API Key. O projeto indica que pelo menos uma delas deve estar ativada.

• Como funciona a sincronização do Google Calendar? Nas configurações do Google Calendar, gere ou copie um “endereço secreto iCal” (formato iCal) e cole essa URL em Configurações > Google Calendar no app.

• Onde os dados são armazenados? O projeto adota abordagem local-first: histórico de conversas é armazenado localmente, e chaves de API adicionadas nas configurações são criptografadas.

• Posso posicionar a ilha de forma diferente? Sim. As configurações incluem opções de posicionamento para colocar a ilha na parte Inferior ou Central da tela, e suporta selecionar em qual monitor ela aparece.

Alternativas

• Frameworks de widgets em nível de SO: Em vez de uma UI expansível estilo Dynamic Island, use sistemas de widgets/lançadores de desktop que agregam widgets (clima, calendário, mídia) na tela; os fluxos de trabalho diferem porque o comportamento de expansão e a apresentação em “ilha” podem não ser nativos.
• Apps de controle de mídia: Ferramentas dedicadas de controle de mídia oferecem reprodução e controles de volume mais visualizações, mas podem não incluir o mesmo layout combinado de clima/calendário/IA.
• Integrações de calendário + clima no desktop: Integrações standalone de calendário e clima focam nessas fontes de dados específicas; elas geralmente não agrupam a interface de chat de IA e o padrão de expansão Dynamic Island em um único centro de controle.
• Aplicativos de chatbot locais: Clientes de chat gerais ou frontends de IA locais podem substituir o painel de IA da ilha, mas você perderia o contexto de UI integrado de calendário/mídia/clima da ilha.