🎛️ Xeon Audio Split

Native macOS AI audio stem separation app — split any song into isolated tracks (vocals, drums, bass, guitar, piano and more) 100% locally on Apple Silicon. No cloud, no uploads, no subscriptions.

Music source separation · stem splitter · vocal remover · karaoke maker · drum separation · AI audio tools for macOS

✨ O que ele faz / What it does

• 🎤 Vozes (Mel-Band RoFormer, estado da arte) — e ainda divide em voz principal × coros, efeitos vocais (reverb/eco) e ruído
• 🥁 Bateria completa — ou peça por peça: bumbo, caixa, toms, pratos
• 🎸 Baixo, guitarra, piano e teclados
• 🎚️ Mixer multipista sample-accurate: um único clock de áudio, mute/solo/ volume com rampas sem parar a reprodução, seek suave, atalho de espaço
• 📤 Exportação offline fiel ao que você ouve (WAV PCM 24-bit, detecção de clipping documentada) + faixa "Outros" como complemento exato — a soma das faixas reconstrói a mixagem original com erro ≈ ruído de quantização
• 🔒 Privacidade total: processamento local (PyTorch/MPS + ONNX Runtime/ CoreML), runtime Python embutido e relocatable — sem Homebrew, sem Python do sistema, sem chamadas de rede durante a separação

🧠 Modelos / Models

Categoria	Modelo	Licença dos pesos
Vozes	Kim Mel-Band RoFormer	MIT
Voz principal × coros	UVR-MDX-NET Karaoke 2	MIT + crédito UVR
Efeitos vocais (de-reverb)	UVR-DeEcho-DeReverb	MIT + crédito UVR
Ruído	UVR-DeNoise	MIT + crédito UVR
Bateria/baixo/guitarra/piano	Demucs htdemucs / htdemucs_6s	⚠️ research-only
Peças de bateria	drumsep	⚠️ não declarada

⚠️ Os pesos dos modelos NÃO são distribuídos neste repositório. Os scripts baixam cada modelo da fonte oficial com verificação SHA-256 e registram procedência e licença em um manifesto fail-closed: categorias sem modelo verificado aparecem desativadas na interface, com explicação — nunca geram arquivos silenciosos falsos. Modelos research-only tornam a build resultante apenas de uso local/pessoal (o app marca isso automaticamente). Detalhes: docs/research/model-licenses.md.

🏗️ Arquitetura / Architecture

• UI: SwiftUI (Swift Package Manager, sem Xcode project) — AVFoundation decodifica MP3/M4A/FLAC/AIFF/WAV nativamente (sem ffmpeg no bundle)
• Player: AVAudioEngine, um nó por faixa, início simultâneo no mesmo AVAudioTime → alinhamento de amostra garantido
• Motor: Python embutido (python-build-standalone, arm64, proveniência em PROVENANCE.json) rodando Demucs + audio-separator; eventos JSON por stdout
• Conformidade: SBOM CycloneDX, THIRD_PARTY_NOTICES, textos de licenças e instruções LGPL (libsndfile) gerados do conteúdo real do bundle
• Empacotamento: .app + ZIP + PKG (assinatura Developer ID e notarização suportadas quando há certificado); suíte de 35 verificações obrigatórias com áudio real (scripts/verify_build.py)

app/      SwiftUI (UI, player, exportador, selftest embutido)
engine/   Motor Python (pipeline em cascata, manifesto fail-closed)
scripts/  build do runtime, modelos, empacotamento, SBOM, verificação
docs/     ADRs, pesquisa de licenças, relatórios de verificação

🚀 Build

./scripts/setup-dev-engine.sh                    # venv de desenvolvimento
engine/.venv/bin/python3 scripts/fetch_models.py --models htdemucs,htdemucs_6s,kim_melband_vocals,uvr_mdx_kara2,uvr_deecho_dereverb,uvr_denoise,drumsep
python3 scripts/build_runtime.py                 # runtime embutido
./scripts/build-app.sh --release --with-engine   # bundle completo
./scripts/package.sh                             # ZIP + PKG
python3 scripts/verify_build.py                  # 35 checks com áudio real

Requisitos: macOS 14+, Apple Silicon, Command Line Tools.

⚖️ Licença / License

Código-fonte © 2026 Galeno Garbe — disponibilizado publicamente para leitura e estudo; todos os direitos reservados (nenhuma licença de uso/redistribuição é concedida por enquanto). Os modelos de IA pertencem aos seus autores e têm as licenças listadas acima. Este projeto não é afiliado a Demucs/Meta, UVR, Kimberley Jensen ou audio-separator — apenas os utiliza com os devidos créditos.

Créditos: Demucs (Meta AI) · UVR (Anjok07 & aufr33) · Kim Mel-Band RoFormer · audio-separator · drumsep · python-build-standalone

---

#audio-separation #stem-separation #music-source-separation #vocal-remover #karaoke #demucs #mel-band-roformer #drum-separation #macos #swiftui #apple-silicon #pytorch #onnx #ai-audio #stems