Open-Unmix is a PyTorch-based music source separation toolkit that provides pre-trained models and a flexible framework for separating audio into its constituent parts (vocals, drums, bass, other). The current version is 1.3.0, and the library is actively maintained with regular updates addressing bug fixes, performance improvements, and new model releases.
pip install openunmixVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to use the `separate_audio` function to perform music source separation. It simulates loading a stereo audio signal and outputs a dictionary of separated stems, each as a PyTorch tensor. The `umxl` model is used by default for inference from version 1.2.1 onwards.
To use the previous default, explicitly specify `model_name='umxhq'` when calling separation functions or using the CLI. Update training scripts to use the `--checkpoint` argument instead of `--model`.
Ensure your `torchaudio` installation is version 0.7.0 or newer. Upgrade using `pip install --upgrade torchaudio`.
Review the license terms associated with the `umxl` model. For commercial applications, consider using the `umxhq` model or other alternatives, explicitly specifying them during separation.
Upgrade your Python environment to version 3.9 or higher to use Open-Unmix v1.3.0 and later.
For reliable model downloads, it is recommended to use Open-Unmix v1.3.0 or later. If using older versions and encountering download issues, manually verify the Zenodo model URLs or upgrade.