# Audio Separator ๐ถ
[](https://badge.fury.io/py/audio-separator)
[](https://anaconda.org/conda-forge/audio-separator)
[](https://hub.docker.com/r/beveradb/audio-separator/tags)
[](https://codecov.io/gh/karaokenerds/python-audio-separator)
[](https://colab.research.google.com/github/blane187gt/audio-separator-colab-work/blob/main/audio_separator_Colab_work.ipynb)
[](https://huggingface.co/spaces/theneos/audio-separator)
**Summary:** Easy to use audio stem separation from the command line or as a dependency in your own Python project, using the amazing MDX-Net, VR Arch, Demucs and MDXC models available in UVR by @Anjok07 & @aufr33.
Audio Separator is a Python package that allows you to separate an audio file into various stems, using models trained by @Anjok07 for use with [Ultimate Vocal Remover](https://github.com/Anjok07/ultimatevocalremovergui).
The simplest (and probably most used) use case for this package is to separate an audio file into two stems, Instrumental and Vocals, which can be very useful for producing karaoke videos! However, the models available in UVR can separate audio into many more stems, such as Drums, Bass, Piano, and Guitar, and perform other audio processing tasks, such as denoising or removing echo/reverb.
## Features
- Separate audio into multiple stems, e.g. instrumental and vocals.
- Supports all common audio formats (WAV, MP3, FLAC, M4A, etc.)
- Ability to inference using a pre-trained model in PTH or ONNX format.
- CLI support for easy use in scripts and batch processing.
- Python API for integration into other projects.
## Installation ๐ ๏ธ
### ๐ณ Docker
If you're able to use docker, you don't actually need to _install_ anything - there are [images published on Docker Hub](https://hub.docker.com/r/beveradb/audio-separator/tags) for GPU (CUDA) and CPU inferencing, for both `amd64` and `arm64` platforms.
You probably want to volume-mount a folder containing whatever file you want to separate, which can then also be used as the output folder.
For instance, if your current directory has the file `input.wav`, you could execute `audio-separator` as shown below (see [usage](#usage-) section for more details):
```sh
docker run -it -v `pwd`:/workdir beveradb/audio-separator input.wav
```
If you're using a machine with a GPU, you'll want to use the GPU specific image and pass in the GPU device to the container, like this:
```sh
docker run -it --gpus all -v `pwd`:/workdir beveradb/audio-separator:gpu input.wav
```
If the GPU isn't being detected, make sure your docker runtime environment is passing through the GPU correctly - there are [various guides](https://www.celantur.com/blog/run-cuda-in-docker-on-linux/) online to help with that.
### ๐ฎ Nvidia GPU with CUDA or ๐งช Google Colab
**Supported CUDA Versions:** 11.8 and 12.2
๐ฌ If successfully configured, you should see this log message when running `audio-separator --env_info`:
`ONNXruntime has CUDAExecutionProvider available, enabling acceleration`
Conda:
```sh
conda install pytorch=*=*cuda* onnxruntime=*=*cuda* audio-separator -c pytorch -c conda-forge
```
Pip:
```sh
pip install "audio-separator[gpu]"
```
Docker:
```sh
beveradb/audio-separator:gpu
```
### ๏ฃฟ Apple Silicon, macOS Sonoma+ with M1 or newer CPU (CoreML acceleration)
๐ฌ If successfully configured, you should see this log message when running `audio-separator --env_info`:
`ONNXruntime has CoreMLExecutionProvider available, enabling acceleration`
Pip:
```sh
pip install "audio-separator[cpu]"
```
### ๐ข No hardware acceleration, CPU only
Conda:
```sh
conda install audio-separator-c pytorch -c conda-forge
```
Pip:
```sh
pip install "audio-separator[cpu]"
```
Docker:
```sh
beveradb/audio-separator
```
### ๐ฅ FFmpeg dependency
๐ฌ To test if `audio-separator` has been successfully configured to use FFmpeg, run `audio-separator --env_info`. The log will show `FFmpeg installed`.
If you installed `audio-separator` using `conda` or `docker`, FFmpeg should already be available in your environment.
You may need to separately install FFmpeg. It should be easy to install on most platforms, e.g.:
๐ง Debian/Ubuntu:
```sh
apt-get update; apt-get install -y ffmpeg
```
๏ฃฟ macOS:
```sh
brew update; brew install ffmpeg
```
## GPU / CUDA specific installation steps with Pip
In theory, all you should need to do to get `audio-separator` working with a GPU is install it with the `[gpu]` extra as above.
However, sometimes getting both PyTorch and ONNX Runtime working with CUDA support can be a bit tricky so it may not work that easily.
You may need to reinstall both packages directly, allowing pip to calculate the right versions for your platform, for example:
- `pip uninstall torch onnxruntime`
- `pip cache purge`
- `pip install --force-reinstall torch torchvision torchaudio`
- `pip install --force-reinstall onnxruntime-gpu`
I generally recommend installing the latest version of PyTorch for your environment using the command recommended by the wizard here:
<https://pytorch.org/get-started/locally/>
### Multiple CUDA library versions may be needed
Depending on your CUDA version and environment, you may need to install specific version(s) of CUDA libraries for ONNX Runtime to use your GPU.
๐งช Google Colab, for example, now uses CUDA 12 by default, but ONNX Runtime still needs CUDA 11 libraries to work.
If you see the error `Failed to load library` or `cannot open shared object file` when you run `audio-separator`, this is likely the issue.
You can install the CUDA 11 libraries _alongside_ CUDA 12 like so:
```sh
apt update; apt install nvidia-cuda-toolkit
```
If you encounter the following messages when running on Google Colab or in another environment:
```
[E:onnxruntime:Default, provider_bridge_ort.cc:1862 TryGetProviderInfo_CUDA] /onnxruntime_src/onnxruntime/core/session/provider_bridge_ort.cc:1539 onnxruntime::Provider& onnxruntime::ProviderLibrary::Get() [ONNXRuntimeError] : 1 : FAIL : Failed to load library libonnxruntime_providers_cuda.so with error: libcudnn_adv.so.9: cannot open shared object file: No such file or directory
[W:onnxruntime:Default, onnxruntime_pybind_state.cc:993 CreateExecutionProviderInstance] Failed to create CUDAExecutionProvider. Require cuDNN 9.* and CUDA 12.*. Please install all dependencies as mentioned in the GPU requirements page (https://onnxruntime.ai/docs/execution-providers/CUDA-ExecutionProvider.html#requirements), make sure they're in the PATH, and that your GPU is supported.
```
You can resolve this by running the following command:
```sh
python -m pip install ort-nightly-gpu --index-url=https://aiinfra.pkgs.visualstudio.com/PublicPackages/_packaging/ort-cuda-12-nightly/pypi/simple/
```
> Note: if anyone knows how to make this cleaner so we can support both different platform-specific dependencies for hardware acceleration without a separate installation process for each, please let me know or raise a PR!
## Usage ๐
### Gradio Interface
```sh
usage: audio-separator-app [--share] [--open]
Params:
--share Opens public access to the interface (for servers, Google Colab, Kaggle, etc.).
--open Automatically opens the interface in a new browser tab.
```
Once the following output message `Running on local URL: http://127.0.0.1:7860` or `Running on public URL: https://28425b3eb261b9ddc6.gradio.live` appears, you can click on the link to open a tab with the WebUI.
### Command Line Interface (CLI)
You can use Audio Separator via the command line, for example:
```sh
audio-separator /path/to/your/input/audio.wav --model_filename UVR-MDX-NET-Inst_HQ_3.onnx
```
This command will download the specified model file, process the `audio.wav` input audio and generate two new files in the current directory, one containing vocals and one containing instrumental.
**Note:** You do not need to download any files yourself - audio-separator does that automatically for you!
To see a list of supported models, run `audio-separator --list_models`
Any file listed in the list models output can be specified (with file extension) with the model_filename parameter (e.g. `--model_filename UVR_MDXNET_KARA_2.onnx`) and it will be automatically downloaded to the `--model_file_dir` (default: `/tmp/audio-separator-models/`) folder on first usage.
### Full command-line interface options
```sh
usage: audio-separator [-h] [-v] [-d] [-e] [-l] [--log_level LOG_LEVEL] [-m MODEL_FILENAME] [--output_format OUTPUT_FORMAT] [--output_dir OUTPUT_DIR] [--model_file_dir MODEL_FILE_DIR] [--invert_spect]
[--normalization NORMALIZATION] [--single_stem SINGLE_STEM] [--sample_rate SAMPLE_RATE] [--use_autocast] [--mdx_segment_size MDX_SEGMENT_SIZE] [--mdx_overlap MDX_OVERLAP] [--mdx_batch_size MDX_BATCH_SIZE]
[--mdx_hop_length MDX_HOP_LENGTH] [--mdx_enable_denoise] [--vr_batch_size VR_BATCH_SIZE] [--vr_window_size VR_WINDOW_SIZE] [--vr_aggression VR_AGGRESSION] [--vr_enable_tta]
[--vr_high_end_process] [--vr_enable_post_process] [--vr_post_process_threshold VR_POST_PROCESS_THRESHOLD] [--demucs_segment_size DEMUCS_SEGMENT_SIZE] [--demucs_shifts DEMUCS_SHIFTS]
[--demucs_overlap DEMUCS_OVERLAP] [--demucs_segments_enabled DEMUCS_SEGMENTS_ENABLED] [--mdxc_segment_size MDXC_SEGMENT_SIZE] [--mdxc_override_model_segment_size]
[--mdxc_overlap MDXC_OVERLAP] [--mdxc_batch_size MDXC_BATCH_SIZE] [--mdxc_pitch_shift MDXC_PITCH_SHIFT]
[audio_file]
Separate audio file into different stems.
positional arguments:
audio_file The audio file path to separate, in any common format.
options:
-h, --help Show this help message and exit.
Info and Debugging:
-v, --version Show the program version number and exit.
-d, --debug Enable debug logging, equivalent to --log_level=debug.
-e, --env_info Print environment information and exit.
-l, --list_models List all supported models and exit.
--log_level LOG_LEVEL Log level, e.g., info, debug, warning (default: info).
Separation I/O Params:
-m MODEL_FILENAME, --model_filename MODEL_FILENAME Model to use for separation (default: UVR-MDX-NET-Inst_HQ_3.onnx). Example: -m 2_HP-UVR.pth
--output_format OUTPUT_FORMAT Output format for separated files, any common format (default: FLAC). Example: --output_format=MP3
--output_dir OUTPUT_DIR Directory to write output files (default: <current dir>). Example: --output_dir=/app/separated
--model_file_dir MODEL_FILE_DIR Model files directory (default: /tmp/audio-separator-models/). Example: --model_file_dir=/app/models
Common Separation Parameters:
--invert_spect Invert secondary stem using spectogram (default: False). Example: --invert_spect
--normalization NORMALIZATION Value by which to multiply the amplitude of the output files (default: 0.9). Example: --normalization=0.7
--single_stem SINGLE_STEM Output only single stem, e.g., Instrumental, Vocals, Drums, Bass, Guitar, Piano, Other. Example: --single_stem=Instrumental
--sample_rate SAMPLE_RATE Set the sample rate of the output audio (default: 44100). Example: --sample_rate=44100
--use_autocast Use PyTorch autocast for faster inference (default: False). Do not use for CPU inference. Example: --use_autocast
--custom_output_names Custom names for all output files in JSON format (default: None). Example: --custom_output_names='{"Vocals": "vocals_output", "Drums": "drums_output"}'
MDX Architecture Parameters:
--mdx_segment_size MDX_SEGMENT_SIZE Larger consumes more resources, but may give better results (default: 256). Example: --mdx_segment_size=256
--mdx_overlap MDX_OVERLAP Amount of overlap between prediction windows, 0.001-0.999. Higher is better but slower (default: 0.25). Example: --mdx_overlap=0.25
--mdx_batch_size MDX_BATCH_SIZE Larger consumes more RAM but may process slightly faster (default: 1). Example: --mdx_batch_size=4
--mdx_hop_length MDX_HOP_LENGTH Usually called stride in neural networks; only change if you know what you do (default: 1024). Example: --mdx_hop_length=1024
--mdx_enable_denoise Enable denoising after separation (default: False). Example: --mdx_enable_denoise
VR Architecture Parameters:
--vr_batch_size VR_BATCH_SIZE Number of "batches" to process at a time. Higher = more RAM, slightly faster processing (default: 1). Example: --vr_batch_size=16
--vr_window_size VR_WINDOW_SIZE Balance quality and speed. 1024 = fast but lower, 320 = slower but better quality (default: 512). Example: --vr_window_size=320
--vr_aggression VR_AGGRESSION Intensity of primary stem extraction, -100 - 100. Typically 5 for vocals & instrumentals (default: 5). Example: --vr_aggression=2
--vr_enable_tta Enable Test-Time-Augmentation; slow but improves quality (default: False). Example: --vr_enable_tta
--vr_high_end_process Mirror the missing frequency range of the output (default: False). Example: --vr_high_end_process
--vr_enable_post_process Identify leftover artifacts within vocal output; may improve separation for some songs (default: False). Example: --vr_enable_post_process
--vr_post_process_threshold VR_POST_PROCESS_THRESHOLD Threshold for post_process feature: 0.1-0.3 (default: 0.2). Example: --vr_post_process_threshold=0.1
Demucs Architecture Parameters:
--demucs_segment_size DEMUCS_SEGMENT_SIZE Size of segments into which the audio is split, 1-100. Higher = slower but better quality (default: Default). Example: --demucs_segment_size=256
--demucs_shifts DEMUCS_SHIFTS Number of predictions with random shifts, higher = slower but better quality (default: 2). Example: --demucs_shifts=4
--demucs_overlap DEMUCS_OVERLAP Overlap between prediction windows, 0.001-0.999. Higher = slower but better quality (default: 0.25). Example: --demucs_overlap=0.25
--demucs_segments_enabled DEMUCS_SEGMENTS_ENABLED Enable segment-wise processing (default: True). Example: --demucs_segments_enabled=False
MDXC Architecture Parameters:
--mdxc_segment_size MDXC_SEGMENT_SIZE Larger consumes more resources, but may give better results (default: 256). Example: --mdxc_segment_size=256
--mdxc_override_model_segment_size Override model default segment size instead of using the model default value. Example: --mdxc_override_model_segment_size
--mdxc_overlap MDXC_OVERLAP Amount of overlap between prediction windows, 2-50. Higher is better but slower (default: 8). Example: --mdxc_overlap=8
--mdxc_batch_size MDXC_BATCH_SIZE Larger consumes more RAM but may process slightly faster (default: 1). Example: --mdxc_batch_size=4
--mdxc_pitch_shift MDXC_PITCH_SHIFT Shift audio pitch by a number of semitones while processing. May improve output for deep/high vocals (default: 0). Example: --mdxc_pitch_shift=2
```
### As a Dependency in a Python Project
You can use Audio Separator in your own Python project. Here's a minimal example using the default two stem (Instrumental and Vocals) model:
```python
from audio_separator.separator import Separator
# Initialize the Separator class (with optional configuration properties, below)
separator = Separator()
# Load a machine learning model (if unspecified, defaults to 'model_mel_band_roformer_ep_3005_sdr_11.4360.ckpt')
separator.load_model()
# Perform the separation on specific audio files without reloading the model
output_files = separator.separate('audio1.wav')
print(f"Separation complete! Output file(s): {' '.join(output_files)}")
```
#### Batch processing and processing with multiple models
You can process multiple files without reloading the model to save time and memory.
You only need to load a model when choosing or changing models. See example below:
```python
from audio_separator.separator import Separator
# Initialize the Separator with other configuration properties, below
separator = Separator()
# Load a model
separator.load_model(model_filename='UVR-MDX-NET-Inst_HQ_3.onnx')
# Separate multiple audio files without reloading the model
output_file_paths_1 = separator.separate('audio1.wav')
output_file_paths_2 = separator.separate('audio2.wav')
output_file_paths_3 = separator.separate('audio3.wav')
# Load a different model
separator.load_model(model_filename='UVR_MDXNET_KARA_2.onnx')
# Separate the same files with the new model
output_file_paths_4 = separator.separate('audio1.wav')
output_file_paths_5 = separator.separate('audio2.wav')
output_file_paths_6 = separator.separate('audio3.wav')
```
#### Renaming Stems
You can rename the output files by specifying the desired names. For example:
```python
output_names = {
"Vocals": "vocals_output",
"Instrumental": "instrumental_output",
}
output_files = separator.separate('audio1.wav', output_names)
```
In this case, the output file names will be: `vocals_output.wav` and `instrumental_output.wav`.
You can also rename specific stems:
- To rename the Vocals stem:
```python
output_names = {
"Vocals": "vocals_output",
}
output_files = separator.separate('audio1.wav', output_names)
```
> The output files will be named: `vocals_output.wav` and `audio1_(Instrumental)_model_mel_band_roformer_ep_3005_sdr_11.wav`
- To rename the Instrumental stem:
```python
output_names = {
"Instrumental": "instrumental_output",
}
output_files = separator.separate('audio1.wav', output_names)
```
> The output files will be named: `audio1_(Vocals)_model_mel_band_roformer_ep_3005_sdr_11.wav` and `instrumental_output.wav`
- List of stems for Demucs models:
- htdemucs_6s.yaml
```python
output_names = {
"Vocals": "vocals_output",
"Drums": "drums_output",
"Bass": "bass_output",
"Other": "other_output",
"Guitar": "guitar_output",
"Piano": "piano_output",
}
```
- Other Demucs models
```python
output_names = {
"Vocals": "vocals_output",
"Drums": "drums_output",
"Bass": "bass_output",
"Other": "other_output",
}
```
## Parameters for the Separator class
- **`log_level`:** (Optional) Logging level, e.g., INFO, DEBUG, WARNING. `Default: logging.INFO`
- **`log_formatter`:** (Optional) The log format. Default: None, which falls back to '%(asctime)s - %(levelname)s - %(module)s - %(message)s'
- **`model_file_dir`:** (Optional) Directory to cache model files in. `Default: /tmp/audio-separator-models/`
- **`output_dir`:** (Optional) Directory where the separated files will be saved. If not specified, uses the current directory.
- **`output_format`:** (Optional) Format to encode output files, any common format (WAV, MP3, FLAC, M4A, etc.). `Default: WAV`
- **`normalization_threshold`:** (Optional) The amount by which the amplitude of the output audio will be multiplied. `Default: 0.9`
- **`amplification_threshold`:** (Optional) The minimum amplitude level at which the waveform will be amplified. If the peak amplitude of the audio is below this threshold, the waveform will be scaled up to meet it. `Default: 0.6`
- **`output_single_stem`:** (Optional) Output only a single stem, such as 'Instrumental' and 'Vocals'. `Default: None`
- **`invert_using_spec`:** (Optional) Flag to invert using spectrogram. `Default: False`
- **`sample_rate`:** (Optional) Set the sample rate of the output audio. `Default: 44100`
- **`use_soundfile`:** (Optional) Use soundfile for output writing, can solve OOM issues, especially on longer audio.
- **`use_autocast`:** (Optional) Flag to use PyTorch autocast for faster inference. Do not use for CPU inference. `Default: False`
- **`mdx_params`:** (Optional) MDX Architecture Specific Attributes & Defaults. `Default: {"hop_length": 1024, "segment_size": 256, "overlap": 0.25, "batch_size": 1, "enable_denoise": False}`
- **`vr_params`:** (Optional) VR Architecture Specific Attributes & Defaults. `Default: {"batch_size": 1, "window_size": 512, "aggression": 5, "enable_tta": False, "enable_post_process": False, "post_process_threshold": 0.2, "high_end_process": False}`
- **`demucs_params`:** (Optional) Demucs Architecture Specific Attributes & Defaults. `Default: {"segment_size": "Default", "shifts": 2, "overlap": 0.25, "segments_enabled": True}`
- **`mdxc_params`:** (Optional) MDXC Architecture Specific Attributes & Defaults. `Default: {"segment_size": 256, "override_model_segment_size": False, "batch_size": 1, "overlap": 8, "pitch_shift": 0}`
## Requirements ๐
Python >= 3.10
Libraries: torch, onnx, onnxruntime, numpy, librosa, requests, six, tqdm, pydub
## Developing Locally
This project uses Poetry for dependency management and packaging. Follow these steps to setup a local development environment:
### Prerequisites
- Make sure you have Python 3.10 or newer installed on your machine.
- Install Conda (I recommend Miniforge: [Miniforge GitHub](https://github.com/conda-forge/miniforge)) to manage your Python virtual environments
### Clone the Repository
Clone the repository to your local machine:
```sh
git clone https://github.com/YOUR_USERNAME/audio-separator.git
cd audio-separator
```
Replace `YOUR_USERNAME` with your GitHub username if you've forked the repository, or use the main repository URL if you have the permissions.
### Create and activate the Conda Environment
To create and activate the conda environment, use the following commands:
```sh
conda env create
conda activate audio-separator-dev
```
### Install Dependencies
Once you're inside the conda env, run the following command to install the project dependencies:
```sh
poetry install
```
Install extra dependencies depending if you're running with GPU or CPU.
```sh
poetry install --extras "cpu"
```
or
```sh
poetry install --extras "gpu"
```
### Running the Command-Line Interface Locally
You can run the CLI command directly within the virtual environment. For example:
```sh
audio-separator path/to/your/audio-file.wav
```
### Deactivate the Virtual Environment
Once you are done with your development work, you can exit the virtual environment by simply typing:
```sh
conda deactivate
```
### Building the Package
To build the package for distribution, use the following command:
```sh
poetry build
```
This will generate the distribution packages in the dist directory - but for now only @beveradb will be able to publish to PyPI.
## How to Use in Colab
1. **Link Input**:
- **video_url**: This input is where you paste the URL of the audio or video you want to download. It can be from various platforms supported by yt-dlp. For a full list of supported websites, refer to [this link](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md).
- Example:
```
https://www.youtube.com/watch?v=exampleID
```
2. **Input Audio File for Separation**:
- **input**: This is the file path of the audio you want to separate. After downloading the audio file, you will need to specify this path to continue with separation.
- Example:
```
/content/ytdl/your_downloaded_audio.wav
```
3. **Output Directory**:
- **output**: This is the path where the separated files will be saved. It defaults to `/content/output` but can be changed to another directory if desired.
- Example:
```
/content/custom_output
```
## Contributing ๐ค
Contributions are very much welcome! Please fork the repository and submit a pull request with your changes, and I'll try to review, merge and publish promptly!
- This project is 100% open-source and free for anyone to use and modify as they wish.
- If the maintenance workload for this repo somehow becomes too much for me I'll ask for volunteers to share maintainership of the repo, though I don't think that is very likely
- Development and support for the MDX-Net separation models is part of the main [UVR project](https://github.com/Anjok07/ultimatevocalremovergui), this repo is just a CLI/Python package wrapper to simplify running those models programmatically. So, if you want to try and improve the actual models, please get involved in the UVR project and look for guidance there!
## License ๐
This project is licensed under the MIT [License](LICENSE).
- **Please Note:** If you choose to integrate this project into some other project using the default model or any other model trained as part of the [UVR](https://github.com/Anjok07/ultimatevocalremovergui) project, please honor the MIT license by providing credit to UVR and its developers!
## Credits ๐
- [Anjok07](https://github.com/Anjok07) - Author of [Ultimate Vocal Remover GUI](https://github.com/Anjok07/ultimatevocalremovergui), which almost all of the code in this repo was copied from! Definitely deserving of credit for anything good from this project. Thank you!
- [DilanBoskan](https://github.com/DilanBoskan) - Your contributions at the start of this project were essential to the success of UVR. Thank you!
- [Kuielab & Woosung Choi](https://github.com/kuielab) - Developed the original MDX-Net AI code.
- [KimberleyJSN](https://github.com/KimberleyJensen) - Advised and aided the implementation of the training scripts for MDX-Net and Demucs. Thank you!
- [Hv](https://github.com/NaJeongMo/Colab-for-MDX_B) - Helped implement chunks into the MDX-Net AI code. Thank you!
- [zhzhongshi](https://github.com/zhzhongshi) - Helped add support for the MDXC models in `audio-separator`. Thank you!
## Contact ๐
For questions or feedback, please raise an issue or reach out to @beveradb ([Andrew Beveridge](mailto:andrew@beveridge.uk)) directly.
## Sponsors
<!-- sponsors --><!-- sponsors -->
Raw data
{
"_id": null,
"home_page": "https://github.com/Bebra777228/Audio-Separator-UI",
"name": "audio-separator-ui",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "audio, sound, karaoke, ui",
"author": "Andrew Beveridge",
"author_email": "andrew@beveridge.uk",
"download_url": "https://files.pythonhosted.org/packages/2e/e8/59116f4917ac351d503613a4441fe3b196a237f4c1e651f5c8b8d1890192/audio_separator_ui-0.25.0.tar.gz",
"platform": null,
"description": "# Audio Separator \ud83c\udfb6\n\n[](https://badge.fury.io/py/audio-separator)\n[](https://anaconda.org/conda-forge/audio-separator)\n[](https://hub.docker.com/r/beveradb/audio-separator/tags)\n[](https://codecov.io/gh/karaokenerds/python-audio-separator)\n[](https://colab.research.google.com/github/blane187gt/audio-separator-colab-work/blob/main/audio_separator_Colab_work.ipynb)\n[](https://huggingface.co/spaces/theneos/audio-separator)\n\n**Summary:** Easy to use audio stem separation from the command line or as a dependency in your own Python project, using the amazing MDX-Net, VR Arch, Demucs and MDXC models available in UVR by @Anjok07 & @aufr33.\n\nAudio Separator is a Python package that allows you to separate an audio file into various stems, using models trained by @Anjok07 for use with [Ultimate Vocal Remover](https://github.com/Anjok07/ultimatevocalremovergui).\n\nThe simplest (and probably most used) use case for this package is to separate an audio file into two stems, Instrumental and Vocals, which can be very useful for producing karaoke videos! However, the models available in UVR can separate audio into many more stems, such as Drums, Bass, Piano, and Guitar, and perform other audio processing tasks, such as denoising or removing echo/reverb.\n\n## Features\n\n- Separate audio into multiple stems, e.g. instrumental and vocals.\n- Supports all common audio formats (WAV, MP3, FLAC, M4A, etc.)\n- Ability to inference using a pre-trained model in PTH or ONNX format.\n- CLI support for easy use in scripts and batch processing.\n- Python API for integration into other projects.\n\n## Installation \ud83d\udee0\ufe0f\n\n### \ud83d\udc33 Docker\n\nIf you're able to use docker, you don't actually need to _install_ anything - there are [images published on Docker Hub](https://hub.docker.com/r/beveradb/audio-separator/tags) for GPU (CUDA) and CPU inferencing, for both `amd64` and `arm64` platforms.\n\nYou probably want to volume-mount a folder containing whatever file you want to separate, which can then also be used as the output folder.\n\nFor instance, if your current directory has the file `input.wav`, you could execute `audio-separator` as shown below (see [usage](#usage-) section for more details):\n\n```sh\ndocker run -it -v `pwd`:/workdir beveradb/audio-separator input.wav\n```\n\nIf you're using a machine with a GPU, you'll want to use the GPU specific image and pass in the GPU device to the container, like this:\n\n```sh\ndocker run -it --gpus all -v `pwd`:/workdir beveradb/audio-separator:gpu input.wav\n```\n\nIf the GPU isn't being detected, make sure your docker runtime environment is passing through the GPU correctly - there are [various guides](https://www.celantur.com/blog/run-cuda-in-docker-on-linux/) online to help with that.\n\n### \ud83c\udfae Nvidia GPU with CUDA or \ud83e\uddea Google Colab\n\n**Supported CUDA Versions:** 11.8 and 12.2\n\n\ud83d\udcac If successfully configured, you should see this log message when running `audio-separator --env_info`:\n `ONNXruntime has CUDAExecutionProvider available, enabling acceleration`\n\nConda:\n```sh\nconda install pytorch=*=*cuda* onnxruntime=*=*cuda* audio-separator -c pytorch -c conda-forge\n```\n\nPip:\n```sh\npip install \"audio-separator[gpu]\"\n```\n\nDocker:\n```sh\nbeveradb/audio-separator:gpu\n```\n\n### \uf8ff Apple Silicon, macOS Sonoma+ with M1 or newer CPU (CoreML acceleration)\n\n\ud83d\udcac If successfully configured, you should see this log message when running `audio-separator --env_info`:\n `ONNXruntime has CoreMLExecutionProvider available, enabling acceleration`\n\nPip:\n```sh\npip install \"audio-separator[cpu]\"\n```\n\n### \ud83d\udc22 No hardware acceleration, CPU only\n\nConda:\n```sh\nconda install audio-separator-c pytorch -c conda-forge\n```\n\nPip:\n```sh\npip install \"audio-separator[cpu]\"\n```\n\nDocker:\n```sh\nbeveradb/audio-separator\n```\n\n### \ud83c\udfa5 FFmpeg dependency\n\n\ud83d\udcac To test if `audio-separator` has been successfully configured to use FFmpeg, run `audio-separator --env_info`. The log will show `FFmpeg installed`.\n\nIf you installed `audio-separator` using `conda` or `docker`, FFmpeg should already be available in your environment.\n\nYou may need to separately install FFmpeg. It should be easy to install on most platforms, e.g.:\n\n\ud83d\udc27 Debian/Ubuntu:\n```sh\napt-get update; apt-get install -y ffmpeg\n```\n\n\uf8ff macOS:\n```sh\nbrew update; brew install ffmpeg\n```\n\n## GPU / CUDA specific installation steps with Pip\n\nIn theory, all you should need to do to get `audio-separator` working with a GPU is install it with the `[gpu]` extra as above.\n\nHowever, sometimes getting both PyTorch and ONNX Runtime working with CUDA support can be a bit tricky so it may not work that easily.\n\nYou may need to reinstall both packages directly, allowing pip to calculate the right versions for your platform, for example:\n\n- `pip uninstall torch onnxruntime`\n- `pip cache purge`\n- `pip install --force-reinstall torch torchvision torchaudio`\n- `pip install --force-reinstall onnxruntime-gpu`\n\nI generally recommend installing the latest version of PyTorch for your environment using the command recommended by the wizard here:\n<https://pytorch.org/get-started/locally/>\n\n### Multiple CUDA library versions may be needed\n\nDepending on your CUDA version and environment, you may need to install specific version(s) of CUDA libraries for ONNX Runtime to use your GPU.\n\n\ud83e\uddea Google Colab, for example, now uses CUDA 12 by default, but ONNX Runtime still needs CUDA 11 libraries to work.\n\nIf you see the error `Failed to load library` or `cannot open shared object file` when you run `audio-separator`, this is likely the issue.\n\nYou can install the CUDA 11 libraries _alongside_ CUDA 12 like so:\n```sh\napt update; apt install nvidia-cuda-toolkit\n```\n\nIf you encounter the following messages when running on Google Colab or in another environment:\n```\n[E:onnxruntime:Default, provider_bridge_ort.cc:1862 TryGetProviderInfo_CUDA] /onnxruntime_src/onnxruntime/core/session/provider_bridge_ort.cc:1539 onnxruntime::Provider& onnxruntime::ProviderLibrary::Get() [ONNXRuntimeError] : 1 : FAIL : Failed to load library libonnxruntime_providers_cuda.so with error: libcudnn_adv.so.9: cannot open shared object file: No such file or directory\n\n[W:onnxruntime:Default, onnxruntime_pybind_state.cc:993 CreateExecutionProviderInstance] Failed to create CUDAExecutionProvider. Require cuDNN 9.* and CUDA 12.*. Please install all dependencies as mentioned in the GPU requirements page (https://onnxruntime.ai/docs/execution-providers/CUDA-ExecutionProvider.html#requirements), make sure they're in the PATH, and that your GPU is supported.\n```\nYou can resolve this by running the following command:\n```sh\npython -m pip install ort-nightly-gpu --index-url=https://aiinfra.pkgs.visualstudio.com/PublicPackages/_packaging/ort-cuda-12-nightly/pypi/simple/\n```\n\n> Note: if anyone knows how to make this cleaner so we can support both different platform-specific dependencies for hardware acceleration without a separate installation process for each, please let me know or raise a PR!\n\n## Usage \ud83d\ude80\n\n### Gradio Interface\n\n```sh\nusage: audio-separator-app [--share] [--open]\n\nParams:\n --share Opens public access to the interface (for servers, Google Colab, Kaggle, etc.).\n --open Automatically opens the interface in a new browser tab.\n\n```\n\nOnce the following output message `Running on local URL: http://127.0.0.1:7860` or `Running on public URL: https://28425b3eb261b9ddc6.gradio.live` appears, you can click on the link to open a tab with the WebUI.\n\n### Command Line Interface (CLI)\n\nYou can use Audio Separator via the command line, for example:\n\n```sh\naudio-separator /path/to/your/input/audio.wav --model_filename UVR-MDX-NET-Inst_HQ_3.onnx\n```\n\nThis command will download the specified model file, process the `audio.wav` input audio and generate two new files in the current directory, one containing vocals and one containing instrumental.\n\n**Note:** You do not need to download any files yourself - audio-separator does that automatically for you!\n\nTo see a list of supported models, run `audio-separator --list_models`\n\nAny file listed in the list models output can be specified (with file extension) with the model_filename parameter (e.g. `--model_filename UVR_MDXNET_KARA_2.onnx`) and it will be automatically downloaded to the `--model_file_dir` (default: `/tmp/audio-separator-models/`) folder on first usage.\n\n### Full command-line interface options\n\n```sh\nusage: audio-separator [-h] [-v] [-d] [-e] [-l] [--log_level LOG_LEVEL] [-m MODEL_FILENAME] [--output_format OUTPUT_FORMAT] [--output_dir OUTPUT_DIR] [--model_file_dir MODEL_FILE_DIR] [--invert_spect]\n [--normalization NORMALIZATION] [--single_stem SINGLE_STEM] [--sample_rate SAMPLE_RATE] [--use_autocast] [--mdx_segment_size MDX_SEGMENT_SIZE] [--mdx_overlap MDX_OVERLAP] [--mdx_batch_size MDX_BATCH_SIZE]\n [--mdx_hop_length MDX_HOP_LENGTH] [--mdx_enable_denoise] [--vr_batch_size VR_BATCH_SIZE] [--vr_window_size VR_WINDOW_SIZE] [--vr_aggression VR_AGGRESSION] [--vr_enable_tta]\n [--vr_high_end_process] [--vr_enable_post_process] [--vr_post_process_threshold VR_POST_PROCESS_THRESHOLD] [--demucs_segment_size DEMUCS_SEGMENT_SIZE] [--demucs_shifts DEMUCS_SHIFTS]\n [--demucs_overlap DEMUCS_OVERLAP] [--demucs_segments_enabled DEMUCS_SEGMENTS_ENABLED] [--mdxc_segment_size MDXC_SEGMENT_SIZE] [--mdxc_override_model_segment_size]\n [--mdxc_overlap MDXC_OVERLAP] [--mdxc_batch_size MDXC_BATCH_SIZE] [--mdxc_pitch_shift MDXC_PITCH_SHIFT]\n [audio_file]\n\nSeparate audio file into different stems.\n\npositional arguments:\n audio_file The audio file path to separate, in any common format.\n\noptions:\n -h, --help Show this help message and exit.\n\nInfo and Debugging:\n -v, --version Show the program version number and exit.\n -d, --debug Enable debug logging, equivalent to --log_level=debug.\n -e, --env_info Print environment information and exit.\n -l, --list_models List all supported models and exit.\n --log_level LOG_LEVEL Log level, e.g., info, debug, warning (default: info).\n\nSeparation I/O Params:\n -m MODEL_FILENAME, --model_filename MODEL_FILENAME Model to use for separation (default: UVR-MDX-NET-Inst_HQ_3.onnx). Example: -m 2_HP-UVR.pth\n --output_format OUTPUT_FORMAT Output format for separated files, any common format (default: FLAC). Example: --output_format=MP3\n --output_dir OUTPUT_DIR Directory to write output files (default: <current dir>). Example: --output_dir=/app/separated\n --model_file_dir MODEL_FILE_DIR Model files directory (default: /tmp/audio-separator-models/). Example: --model_file_dir=/app/models\n\nCommon Separation Parameters:\n --invert_spect Invert secondary stem using spectogram (default: False). Example: --invert_spect\n --normalization NORMALIZATION Value by which to multiply the amplitude of the output files (default: 0.9). Example: --normalization=0.7\n --single_stem SINGLE_STEM Output only single stem, e.g., Instrumental, Vocals, Drums, Bass, Guitar, Piano, Other. Example: --single_stem=Instrumental\n --sample_rate SAMPLE_RATE Set the sample rate of the output audio (default: 44100). Example: --sample_rate=44100\n --use_autocast Use PyTorch autocast for faster inference (default: False). Do not use for CPU inference. Example: --use_autocast\n --custom_output_names Custom names for all output files in JSON format (default: None). Example: --custom_output_names='{\"Vocals\": \"vocals_output\", \"Drums\": \"drums_output\"}'\n\nMDX Architecture Parameters:\n --mdx_segment_size MDX_SEGMENT_SIZE Larger consumes more resources, but may give better results (default: 256). Example: --mdx_segment_size=256\n --mdx_overlap MDX_OVERLAP Amount of overlap between prediction windows, 0.001-0.999. Higher is better but slower (default: 0.25). Example: --mdx_overlap=0.25\n --mdx_batch_size MDX_BATCH_SIZE Larger consumes more RAM but may process slightly faster (default: 1). Example: --mdx_batch_size=4\n --mdx_hop_length MDX_HOP_LENGTH Usually called stride in neural networks; only change if you know what you do (default: 1024). Example: --mdx_hop_length=1024\n --mdx_enable_denoise Enable denoising after separation (default: False). Example: --mdx_enable_denoise\n\nVR Architecture Parameters:\n --vr_batch_size VR_BATCH_SIZE Number of \"batches\" to process at a time. Higher = more RAM, slightly faster processing (default: 1). Example: --vr_batch_size=16\n --vr_window_size VR_WINDOW_SIZE Balance quality and speed. 1024 = fast but lower, 320 = slower but better quality (default: 512). Example: --vr_window_size=320\n --vr_aggression VR_AGGRESSION Intensity of primary stem extraction, -100 - 100. Typically 5 for vocals & instrumentals (default: 5). Example: --vr_aggression=2\n --vr_enable_tta Enable Test-Time-Augmentation; slow but improves quality (default: False). Example: --vr_enable_tta\n --vr_high_end_process Mirror the missing frequency range of the output (default: False). Example: --vr_high_end_process\n --vr_enable_post_process Identify leftover artifacts within vocal output; may improve separation for some songs (default: False). Example: --vr_enable_post_process\n --vr_post_process_threshold VR_POST_PROCESS_THRESHOLD Threshold for post_process feature: 0.1-0.3 (default: 0.2). Example: --vr_post_process_threshold=0.1\n\nDemucs Architecture Parameters:\n --demucs_segment_size DEMUCS_SEGMENT_SIZE Size of segments into which the audio is split, 1-100. Higher = slower but better quality (default: Default). Example: --demucs_segment_size=256\n --demucs_shifts DEMUCS_SHIFTS Number of predictions with random shifts, higher = slower but better quality (default: 2). Example: --demucs_shifts=4\n --demucs_overlap DEMUCS_OVERLAP Overlap between prediction windows, 0.001-0.999. Higher = slower but better quality (default: 0.25). Example: --demucs_overlap=0.25\n --demucs_segments_enabled DEMUCS_SEGMENTS_ENABLED Enable segment-wise processing (default: True). Example: --demucs_segments_enabled=False\n\nMDXC Architecture Parameters:\n --mdxc_segment_size MDXC_SEGMENT_SIZE Larger consumes more resources, but may give better results (default: 256). Example: --mdxc_segment_size=256\n --mdxc_override_model_segment_size Override model default segment size instead of using the model default value. Example: --mdxc_override_model_segment_size\n --mdxc_overlap MDXC_OVERLAP Amount of overlap between prediction windows, 2-50. Higher is better but slower (default: 8). Example: --mdxc_overlap=8\n --mdxc_batch_size MDXC_BATCH_SIZE Larger consumes more RAM but may process slightly faster (default: 1). Example: --mdxc_batch_size=4\n --mdxc_pitch_shift MDXC_PITCH_SHIFT Shift audio pitch by a number of semitones while processing. May improve output for deep/high vocals (default: 0). Example: --mdxc_pitch_shift=2\n```\n\n### As a Dependency in a Python Project\n\nYou can use Audio Separator in your own Python project. Here's a minimal example using the default two stem (Instrumental and Vocals) model:\n\n```python\nfrom audio_separator.separator import Separator\n\n# Initialize the Separator class (with optional configuration properties, below)\nseparator = Separator()\n\n# Load a machine learning model (if unspecified, defaults to 'model_mel_band_roformer_ep_3005_sdr_11.4360.ckpt')\nseparator.load_model()\n\n# Perform the separation on specific audio files without reloading the model\noutput_files = separator.separate('audio1.wav')\n\nprint(f\"Separation complete! Output file(s): {' '.join(output_files)}\")\n```\n\n#### Batch processing and processing with multiple models\n\nYou can process multiple files without reloading the model to save time and memory.\n\nYou only need to load a model when choosing or changing models. See example below:\n\n```python\nfrom audio_separator.separator import Separator\n\n# Initialize the Separator with other configuration properties, below\nseparator = Separator()\n\n# Load a model\nseparator.load_model(model_filename='UVR-MDX-NET-Inst_HQ_3.onnx')\n\n# Separate multiple audio files without reloading the model\noutput_file_paths_1 = separator.separate('audio1.wav')\noutput_file_paths_2 = separator.separate('audio2.wav')\noutput_file_paths_3 = separator.separate('audio3.wav')\n\n# Load a different model\nseparator.load_model(model_filename='UVR_MDXNET_KARA_2.onnx')\n\n# Separate the same files with the new model\noutput_file_paths_4 = separator.separate('audio1.wav')\noutput_file_paths_5 = separator.separate('audio2.wav')\noutput_file_paths_6 = separator.separate('audio3.wav')\n```\n\n#### Renaming Stems\n\nYou can rename the output files by specifying the desired names. For example:\n```python\noutput_names = {\n \"Vocals\": \"vocals_output\",\n \"Instrumental\": \"instrumental_output\",\n}\noutput_files = separator.separate('audio1.wav', output_names)\n```\nIn this case, the output file names will be: `vocals_output.wav` and `instrumental_output.wav`.\n\nYou can also rename specific stems:\n\n- To rename the Vocals stem:\n ```python\n output_names = {\n \"Vocals\": \"vocals_output\",\n }\n output_files = separator.separate('audio1.wav', output_names)\n ```\n > The output files will be named: `vocals_output.wav` and `audio1_(Instrumental)_model_mel_band_roformer_ep_3005_sdr_11.wav`\n- To rename the Instrumental stem:\n ```python\n output_names = {\n \"Instrumental\": \"instrumental_output\",\n }\n output_files = separator.separate('audio1.wav', output_names)\n ```\n > The output files will be named: `audio1_(Vocals)_model_mel_band_roformer_ep_3005_sdr_11.wav` and `instrumental_output.wav`\n- List of stems for Demucs models:\n - htdemucs_6s.yaml\n ```python\n output_names = {\n \"Vocals\": \"vocals_output\",\n \"Drums\": \"drums_output\",\n \"Bass\": \"bass_output\",\n \"Other\": \"other_output\",\n \"Guitar\": \"guitar_output\",\n \"Piano\": \"piano_output\",\n }\n ```\n - Other Demucs models\n ```python\n output_names = {\n \"Vocals\": \"vocals_output\",\n \"Drums\": \"drums_output\",\n \"Bass\": \"bass_output\",\n \"Other\": \"other_output\",\n }\n ```\n\n## Parameters for the Separator class\n\n- **`log_level`:** (Optional) Logging level, e.g., INFO, DEBUG, WARNING. `Default: logging.INFO`\n- **`log_formatter`:** (Optional) The log format. Default: None, which falls back to '%(asctime)s - %(levelname)s - %(module)s - %(message)s'\n- **`model_file_dir`:** (Optional) Directory to cache model files in. `Default: /tmp/audio-separator-models/`\n- **`output_dir`:** (Optional) Directory where the separated files will be saved. If not specified, uses the current directory.\n- **`output_format`:** (Optional) Format to encode output files, any common format (WAV, MP3, FLAC, M4A, etc.). `Default: WAV`\n- **`normalization_threshold`:** (Optional) The amount by which the amplitude of the output audio will be multiplied. `Default: 0.9`\n- **`amplification_threshold`:** (Optional) The minimum amplitude level at which the waveform will be amplified. If the peak amplitude of the audio is below this threshold, the waveform will be scaled up to meet it. `Default: 0.6`\n- **`output_single_stem`:** (Optional) Output only a single stem, such as 'Instrumental' and 'Vocals'. `Default: None`\n- **`invert_using_spec`:** (Optional) Flag to invert using spectrogram. `Default: False`\n- **`sample_rate`:** (Optional) Set the sample rate of the output audio. `Default: 44100`\n- **`use_soundfile`:** (Optional) Use soundfile for output writing, can solve OOM issues, especially on longer audio.\n- **`use_autocast`:** (Optional) Flag to use PyTorch autocast for faster inference. Do not use for CPU inference. `Default: False`\n- **`mdx_params`:** (Optional) MDX Architecture Specific Attributes & Defaults. `Default: {\"hop_length\": 1024, \"segment_size\": 256, \"overlap\": 0.25, \"batch_size\": 1, \"enable_denoise\": False}`\n- **`vr_params`:** (Optional) VR Architecture Specific Attributes & Defaults. `Default: {\"batch_size\": 1, \"window_size\": 512, \"aggression\": 5, \"enable_tta\": False, \"enable_post_process\": False, \"post_process_threshold\": 0.2, \"high_end_process\": False}`\n- **`demucs_params`:** (Optional) Demucs Architecture Specific Attributes & Defaults. `Default: {\"segment_size\": \"Default\", \"shifts\": 2, \"overlap\": 0.25, \"segments_enabled\": True}`\n- **`mdxc_params`:** (Optional) MDXC Architecture Specific Attributes & Defaults. `Default: {\"segment_size\": 256, \"override_model_segment_size\": False, \"batch_size\": 1, \"overlap\": 8, \"pitch_shift\": 0}`\n\n## Requirements \ud83d\udccb\n\nPython >= 3.10\n\nLibraries: torch, onnx, onnxruntime, numpy, librosa, requests, six, tqdm, pydub\n\n## Developing Locally\n\nThis project uses Poetry for dependency management and packaging. Follow these steps to setup a local development environment:\n\n### Prerequisites\n\n- Make sure you have Python 3.10 or newer installed on your machine.\n- Install Conda (I recommend Miniforge: [Miniforge GitHub](https://github.com/conda-forge/miniforge)) to manage your Python virtual environments\n\n### Clone the Repository\n\nClone the repository to your local machine:\n\n```sh\ngit clone https://github.com/YOUR_USERNAME/audio-separator.git\ncd audio-separator\n```\n\nReplace `YOUR_USERNAME` with your GitHub username if you've forked the repository, or use the main repository URL if you have the permissions.\n\n### Create and activate the Conda Environment\n\nTo create and activate the conda environment, use the following commands:\n\n```sh\nconda env create\nconda activate audio-separator-dev\n```\n\n### Install Dependencies\n\nOnce you're inside the conda env, run the following command to install the project dependencies:\n\n```sh\npoetry install\n```\n\nInstall extra dependencies depending if you're running with GPU or CPU.\n```sh\npoetry install --extras \"cpu\"\n```\nor\n```sh\npoetry install --extras \"gpu\"\n```\n\n### Running the Command-Line Interface Locally\n\nYou can run the CLI command directly within the virtual environment. For example:\n\n```sh\naudio-separator path/to/your/audio-file.wav\n```\n\n### Deactivate the Virtual Environment\n\nOnce you are done with your development work, you can exit the virtual environment by simply typing:\n\n```sh\nconda deactivate\n```\n\n### Building the Package\n\nTo build the package for distribution, use the following command:\n\n```sh\npoetry build\n```\n\nThis will generate the distribution packages in the dist directory - but for now only @beveradb will be able to publish to PyPI.\n\n\n## How to Use in Colab\n\n1. **Link Input**:\n\n\n\n\n - **video_url**: This input is where you paste the URL of the audio or video you want to download. It can be from various platforms supported by yt-dlp. For a full list of supported websites, refer to [this link](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md).\n\n - Example: \n ``` \n https://www.youtube.com/watch?v=exampleID \n ```\n\n2. **Input Audio File for Separation**:\n\n\n\n\n - **input**: This is the file path of the audio you want to separate. After downloading the audio file, you will need to specify this path to continue with separation.\n\n - Example:\n ``` \n /content/ytdl/your_downloaded_audio.wav \n ```\n\n3. **Output Directory**:\n - **output**: This is the path where the separated files will be saved. It defaults to `/content/output` but can be changed to another directory if desired.\n\n - Example:\n ``` \n /content/custom_output \n ```\n\n## Contributing \ud83e\udd1d\n\nContributions are very much welcome! Please fork the repository and submit a pull request with your changes, and I'll try to review, merge and publish promptly!\n\n- This project is 100% open-source and free for anyone to use and modify as they wish.\n- If the maintenance workload for this repo somehow becomes too much for me I'll ask for volunteers to share maintainership of the repo, though I don't think that is very likely\n- Development and support for the MDX-Net separation models is part of the main [UVR project](https://github.com/Anjok07/ultimatevocalremovergui), this repo is just a CLI/Python package wrapper to simplify running those models programmatically. So, if you want to try and improve the actual models, please get involved in the UVR project and look for guidance there!\n\n## License \ud83d\udcc4\n\nThis project is licensed under the MIT [License](LICENSE).\n\n- **Please Note:** If you choose to integrate this project into some other project using the default model or any other model trained as part of the [UVR](https://github.com/Anjok07/ultimatevocalremovergui) project, please honor the MIT license by providing credit to UVR and its developers!\n\n## Credits \ud83d\ude4f\n\n- [Anjok07](https://github.com/Anjok07) - Author of [Ultimate Vocal Remover GUI](https://github.com/Anjok07/ultimatevocalremovergui), which almost all of the code in this repo was copied from! Definitely deserving of credit for anything good from this project. Thank you!\n- [DilanBoskan](https://github.com/DilanBoskan) - Your contributions at the start of this project were essential to the success of UVR. Thank you!\n- [Kuielab & Woosung Choi](https://github.com/kuielab) - Developed the original MDX-Net AI code.\n- [KimberleyJSN](https://github.com/KimberleyJensen) - Advised and aided the implementation of the training scripts for MDX-Net and Demucs. Thank you!\n- [Hv](https://github.com/NaJeongMo/Colab-for-MDX_B) - Helped implement chunks into the MDX-Net AI code. Thank you!\n- [zhzhongshi](https://github.com/zhzhongshi) - Helped add support for the MDXC models in `audio-separator`. Thank you!\n\n## Contact \ud83d\udc8c\n\nFor questions or feedback, please raise an issue or reach out to @beveradb ([Andrew Beveridge](mailto:andrew@beveridge.uk)) directly.\n\n## Sponsors\n\n<!-- sponsors --><!-- sponsors -->\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Easy to use audio stem separation with a UI, using various models from UVR trained primarily by @Anjok07",
"version": "0.25.0",
"project_urls": {
"Documentation": "https://github.com/Bebra777228/Audio-Separator-UI/blob/main/README.md",
"Homepage": "https://github.com/Bebra777228/Audio-Separator-UI",
"Repository": "https://github.com/Bebra777228/Audio-Separator-UI"
},
"split_keywords": [
"audio",
" sound",
" karaoke",
" ui"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "182832b620c1b1634dbf52f6ef3ede73b77980f5f3eb8dfb9a7a860a06307eb6",
"md5": "2f326dbc637141a04325d0366b5afbdd",
"sha256": "3c407550a345dd11ea10bf3f798208459ef57d6b670812b776c588d8b276daec"
},
"downloads": -1,
"filename": "audio_separator_ui-0.25.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2f326dbc637141a04325d0366b5afbdd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 182871,
"upload_time": "2024-12-09T16:21:22",
"upload_time_iso_8601": "2024-12-09T16:21:22.242787Z",
"url": "https://files.pythonhosted.org/packages/18/28/32b620c1b1634dbf52f6ef3ede73b77980f5f3eb8dfb9a7a860a06307eb6/audio_separator_ui-0.25.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2ee859116f4917ac351d503613a4441fe3b196a237f4c1e651f5c8b8d1890192",
"md5": "9bc2a42a8e2249042c2dc89f88f2e169",
"sha256": "c9dc33a241cc04ac4b2158bde430cedcb7b9dd53b1fc1b69849d3a3fb9cf6493"
},
"downloads": -1,
"filename": "audio_separator_ui-0.25.0.tar.gz",
"has_sig": false,
"md5_digest": "9bc2a42a8e2249042c2dc89f88f2e169",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 142480,
"upload_time": "2024-12-09T16:21:24",
"upload_time_iso_8601": "2024-12-09T16:21:24.541058Z",
"url": "https://files.pythonhosted.org/packages/2e/e8/59116f4917ac351d503613a4441fe3b196a237f4c1e651f5c8b8d1890192/audio_separator_ui-0.25.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-09 16:21:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Bebra777228",
"github_project": "Audio-Separator-UI",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "audio-separator-ui"
}
JSON
