Demucs is a state-of-the-art music source separation model, currently capable of separating drums, bass, and vocals from the rest of the accompaniment. This is a fork of the author's fork of the original Demucs repository. Checkout the paper for more information on the model.
Use the following commands to install FFmpeg:
- macOS:
brew install ffmpeg - Ubuntu/Debian:
sudo apt-get install ffmpeg - Windows: Download from FFmpeg.org
It is recommended to install Demucs using UV, a fast, modern Python package manager with isolated environments.
Use the following commands to install UV:
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"With UV, you can use the uvx command to run Demucs without installing it permanently on your system. This sets up a temporary virtual enviornment for the duration of the command.
uvx --with demucs-inference demucs separate audio_file.mp3Note: Demucs does not specify a specific PyTorch wheel. This means that GPUs will only work on Apple Silicon or Linux with CUDA 12.6 when using this method.
Install Demucs using the following command:
uv pip install demucs-inference --torch-backend=autoThe --torch-backend=auto flag automatically detects your GPU and installs the appropriate PyTorch version. If you are on Windows and have a Intel GPU (XPU), you will need to use --torch-backend=xpu as UV will not automatically detect it.
Install Demucs using the following command:
pip install demucs-inferenceNote: Demucs does not specify a specific PyTorch wheel. You should provide one yourself to ensure GPU support.
After installing Demucs, you can use it like the following:
# View all options
demucs --help
# Separate one audio file
demucs separate audio_file.mp3
# Separate multiple audio files
demucs separate audio_file_1.mp3 audio_file_2.mp3
# Separate all audio files in the current directory
demucs separate *.mp3Demucs provides a Python API for separating audio files. Please refer to the API docs for more information.