🎛️ Sovereign-DSP: Autonomous Raw-to-Master Processing Suite

High-Precision Phase-Linear Audio Processing, Multiband M/S Correlation & Perceptual Loudness Engine
Powered by the AI2Grammy Mastering Core

---

📋 Executive Overview

Sovereign-DSP is a state-of-the-art, high-performance Python signal processing library designed for autonomous audio mastering, high-frequency bandwidth extension, and phase-coherence restoration. Built specifically to process dense electronic, trance, and orchestral mixes, Sovereign-DSP solves digital aliasing, low-end phase smear, and inter-sample peak distortion using pure mathematical principles and industry-standard DSP algorithms.

---

🏗️ Signal Processing Architecture

The engine uses a Hybrid Modular DSP Pipeline (sovereign_dsp.py), enforcing strict floating-point determinism and phase alignment across every frequency band.

graph TD
    Raw[Raw Audio File] --> Import[Audio Loader & Floating-Point Cast]
    Import --> Phase[Multiband M/S Phase Alignment]
    Phase --> BWE[Harmonic Exciter & Bandwidth Extension]
    BWE --> Comp[Adaptive Dynamic Range & Crest Factor Control]
    Comp --> Spatial[Stereo Haas & Mid/Side Field Balancing]
    Spatial --> Tape[Asymmetric Master Tape Saturation]
    Tape --> Limiter[True Peak Limiter & Post-Master LUFS Lock]
    Limiter --> Dither[AES-17 Full-Spectrum Dither]
    Dither --> Master[Export 24-bit FLAC / OGG Master]

Loading

---

🛡️ Core DSP Innovations

🎛️ I. Multiband Mid/Side Phase Correlation

• Mid/Side Decomposition: Splits raw stereo audio into sum (Mid) and difference (Side) components.
• Low-End Mono Lock: Preserves 100% phase-coherence below 600 Hz to prevent low-end cancellation and club system punch degradation.
• High-Frequency Spatialization: Applies frequency-guarded Haas micro-delays to high frequencies (above 6 kHz) for maximum stereo width without comb-filtering transients.

🌊 II. Bandwidth Extension (BWE) & Harmonic Excitation

• Donor-Synthesized Air Band: Generates organic, high-frequency harmonics (14 kHz – 22 kHz) using non-linear tanh excitation and 4th-order Linkwitz-Riley crossover filtering.
• Dynamic Envelope Matching: Matches high-frequency RMS energy dynamically to natural acoustic decay profiles, eliminating digital harshness and brickwall cutoff cliffs.

🔊 III. Perceptual Loudness & True Peak Control

• ITU-R BS.1770-4 Standard: Integrated EBU R128 loudness measurement targeting commercial radio/streaming standards (-9.0 to -8.0 LUFS).
• Inter-Sample Peak Guard: Precision true peak ceiling enforcement (-0.50 dBTP) preventing clipping during lossy AAC/MP3/OGG transcoding on streaming platforms (Spotify, Apple Music).

⚡ IV. Deterministic Execution Architecture

• Cross-Platform Reproducibility: Enforces single-threaded BLAS/MKL execution and explicit PRNG seeds (AI2G_SEED) to ensure bit-identical PCM output across Linux, Windows, and macOS systems.

---

💻 Dependencies & Stack

• Language: Python 3.10+
• DSP & Math Libraries: scipy, numpy, librosa, soundfile
• Loudness Standards: pyloudnorm (EBU R128 / ITU-R BS.1770-4)
• Audio Processing Engine: Spotify pedalboard (High-performance C++ audio plugins)

---

🚀 Quickstart

1. Installation

git clone https://github.com/G3need/Sovereign-DSP.git
cd Sovereign-DSP

# Install core dependencies via requirements.txt
pip install -r requirements.txt

2. Verify Pipeline Compilation

python -m py_compile sovereign_dsp.py

---

Architect & Lead Engineer: Ahmed Geneed
Sovereign Audio Engineering Suite (2026)