Sobre o projeto

KalinkaAI é o aplicativo cliente para o sistema de música Kalinka, uma configuração Hi-Fi auto-hospedada voltada para hardware Raspberry Pi e Linux. Este repositório contém apenas o controle remoto: ele não reproduz nada por conta própria e requer um Kalinka Music Server separado na mesma rede. O servidor, hospedado no repositório KalinkaPlayer, fornece um mecanismo de áudio C++/ALSA, um indexador de biblioteca com enriquecimento de metadados e um mecanismo de busca semântica baseado em CLAP. O aplicativo roda no Android, Windows, desktop Linux e no navegador. Ele descobre um servidor via mDNS ou aceita um endereço inserido manualmente. Um assistente de configuração orienta a primeira conexão. O servidor também expõe um player de navegador na porta 8000, portanto não é estritamente necessário instalar um cliente. Um recurso principal é a busca semântica: uma frase em linguagem natural, como "algo melancólico para esta noite", é transformada em faixas correspondentes, processadas no próprio hardware do usuário. O projeto afirma que não há dependência de nuvem, assinatura ou conta. Os caminhos de instalação estão documentados por plataforma. Os usuários do Android podem instalar via Obtainium, que baixa diretamente do GitHub Releases e mantém o aplicativo atualizado, ou baixar um APK universal manualmente. Os APKs de lançamento são assinados com uma impressão digital SHA-256 de certificado publicada que o Obtainium pode fixar. O Windows x64 distribui um instalador que não é assinado digitalmente, portanto um aviso do SmartScreen é esperado. O Linux x64 é distribuído como um tarball com um script de instalação que adiciona um ícone de inicialização e suporta desinstalação. A opção de navegador não requer instalação. A documentação abrange a instalação do servidor, a configuração inicial e um manual ilustrado do aplicativo que descreve o assistente, o status e as configurações do servidor, pastas de música, busca por IA e enfileiramento. O código-fonte está sob Apache-2.0, enquanto ícones, logotipos e artes estão sob uma licença de ativos separada que exige permissão do autor; as fontes IBM Plex incluídas usam a SIL Open Font License 1.1.