francescos12 / demucs-gui Goto Github PK

This is a GUI for music separation project demucs.

The project aims to let users without any coding experience separate tracks without difficulty. If you have any question about usage or the project, please open an issue to tell us. Since the original project Demucs used scientific library torch, the packed binaries with environment is very large, and we will only pack binaries for formal releases.

Currently I'm training some new great models (like 10-stem model) for this project. However as a student I don't have enough money to rent powerful GPUs. With your help, I can train the new models up to 100x faster. I promise I will use the money only for training models and will release the models to the public for free as long as I can raise $150.

If you like this project, please consider donating to me.

paypal.me/CarlGao4

AliPay QR Code

For Windows: At least Windows 8

For Mac: At least macOS 10.15

For Linux: Any system that can install and run python 3.11 (Because I'll pack the binaries using python 3.11)

Memory: About at least 8GB of total memory (physical and swap) would be required. The longer the track you want to separate, the more memory will be required.

GPU: Only NVIDIA GPUs (whose compute capability should be at least 3.5) and Apple MPS are supported. At least 2GB of private memory is required.

At least Python 3.9 is required. Other requirements please refer to Installing binaries.

Binaries for download are available here.

Please refer to history.md.

If you are using released binaries, please refer to usage.md

This part is written for those who want to run the codes themselves

FFmpeg is a supported audio reader of Demucs-GUI. Demucs-GUI will try to use FFmpeg as long as it is found in the PATH environment variable. Both FFmpeg and FFprobe are required. You can install it from source, use system package manager, download prebuilt binaries or use conda (recommended).

1. Install Python and git. It's recommended to use a virtual environment like conda.
2. Clone this repository and switch to this branch. You should run git submodule update --init --recursive since 1.1a2 version.
3. Use pip to install all packages in requirements.txt.

note: on Linux, PyTorch with CUDA is the default.

# For pip
pip install -r requirements_cuda.txt
# Conda is not available as this project has dependencies only on PyPI

4. Run GuiMain.py and separate your song!

1. Install Python and git. It's recommended to use a virtual environment like conda.
2. Clone this repository and switch to this branch. You should run git submodule update --init --recursive since 1.1a2 version.
3. Skip this step if you don't need to switch the default version of PyTorch. Install torch with cuda under intructions on pyTorch official website. There is no requirement of cuda version, but the version of torch should be 2.0.x (2.1.0 and higher will cause errors sometimes)
4. Use pip to install all packages in requirements_cuda.txt.

# For pip
pip install -r requirements_cuda.txt
# Conda is not available as this project has dependencies only on PyPI

5. Run GuiMain.py and separate your song! If your GPU is not listed in the selector device, Please use CPU instead or open an issue to tell us if you think this is a problem.

1. Install Python (and git if you'd like to clone this repository) to your system.
2. Download zip of this branch and extract it to a folder, or clone this repository and switch to this branch. You should run git submodule update --init --recursive since 1.1a2 version.
3. Skip this step if you don't need to switch the default version of PyTorch. Install torch with cuda under intructions on pyTorch official website. There is no requirement of cuda version, but the version of torch should be 2.0.x (2.1.0 and higher will cause errors sometimes)
4. Use pip to install all packages in requirements_rocm.txt.

# For pip
pip install -r requirements_rocm.txt
# Conda is not available as this project has dependencies only on PyPI

5. Run GuiMain.py and separate your song! If your GPU is not listed in the selector device, Please use CPU instead or open an issue to tell us if you think this is a problem.

Make sure that you have discrete Intel graphics card or an Intel CPU that is 11th generation or newer with integrated graphics card (Because we need its driver)

1. Install latest Intel graphics driver (Windows link). This accelerator requires Intel® Arc™ & Iris® Xe Graphics driver (which means, Intel® Arc™ A-Series Graphics, Intel® Iris® Xe Graphics, and Intel® Core™ Ultra Processors with Intel® Arc™ Graphics). Though I would discourage you to use this "accelerator" with integrated graphics card as it is even slower than pure CPU.
2. Install Python (and git if you'd like to clone this repository) to your system.
3. Download zip of this branch and extract it to a folder, or clone this repository and switch to this branch. You should run git submodule update --init --recursive since 1.1a2 version.
4. Use pip to install all packages in requirements_intel_gpu_mkl.txt.

# For pip
pip install -r requirements_intel_gpu_mkl.txt
# Conda is not available as this project has dependencies only on PyPI

5. Run GuiMain.py and separate your song! If your GPU is not listed in the selector device, Please use CPU instead or open an issue to tell us if you think this is a problem.
6. If it could not start up and sometimes raises an error like OSError: [WinError 126] Error loading "***\torch\lib\backend_with_compiler.dll" or one of its dependencies, you may have to manually download libuv and put it in the folder torch\lib under your python site packages installation path.

This project includes code of Demucs under MIT license.