Nakymm/fretly-audio-analysis

Fretly Audio Analysis

Serviço opcional de análise musical. O Demucs separa voz, bateria, baixo e acompanhamento; o Librosa detecta batidas, extrai cromas da faixa harmônica e classifica acordes maiores e menores.

No Space gratuito configure DEMUCS_DEVICE=cpu. Em produção com GPU dedicada, use DEMUCS_DEVICE=cuda. Configure também ALLOWED_ORIGINS e ANALYSIS_TIMEOUT.

Os endpoints POST /identify e POST /analyze recebem multipart/form-data no campo file. A identificação tenta primeiro os metadados do arquivo, depois Chromaprint + AcoustID/MusicBrainz, opcionalmente AudD, e por último o padrão Artista - Música no nome do arquivo. Para o caminho gratuito e não comercial, registre o aplicativo no AcoustID e configure ACOUSTID_API_KEY. A aplicação usa o serviço quando VITE_AUDIO_ANALYSIS_URL está definido; caso contrário, mantém o analisador local.