README_ko.md
June 29, 2026 · View on GitHub
MSST-WebUI
English | 简体中文 | 繁體中文 | 日本語 | 한국어
Music-Source-Separation-Training용 WebUI 애플리케이션, UVR도 함께 포함되어 있습니다!
Important
이 프로젝트는 곧 유지보수가 중단될 예정입니다. 더 포괄적인 모델을 지원하고, MSST-WebUI보다 추론 속도가 50-100배 빠르며, 더 보기 좋은 GUI를 제공하는 pymss-desktop 사용을 권장합니다.
- Cross-platform desktop GUI for pymss music source separation: pymss-project/pymss-desktop
- Python package for music source separation: pymss-project/pymss
- ComfyUI custom nodes for pymss music source separation: pymss-project/comfy-mss
소개
이 WebUI는 Music-Source-Separation-Training (MSST)를 위한 사용자 인터페이스입니다. 이 저장소는 음악 소스 분리 모델을 학습하기 위한 도구들을 포함하고 있습니다. 본 WebUI를 사용하여 MSST 모델과 VR 모델을 추론할 수 있으며, 사전 설정된 프로세스 페이지에서 처리 과정을 직접 커스터마이징할 수 있습니다.
“Install Models” 메뉴에서 모델을 설치할 수 있으며, 기존에 Ultimate Vocal Remover (UVR)를 다운로드한 경우 VR 모델을 다시 받을 필요 없이 “Settings” 페이지에서 UVR5 모델 폴더를 선택하면 됩니다. 또한 SOME (Singing-Oriented MIDI Extractor)와 고급 앙상블 모드 등 다양한 편의 기능도 제공됩니다.
사용 방법
- Windows: Releases에서 설치 파일을 받거나 저장소를 클론하여 직접 실행합니다.
- Linux/macOS: 저장소를 클론하고 직접 실행합니다.
- Google Colab: 여기 클릭하여 Colab에서 실행합니다.
- UCloud (중국 사용자 전용): 여기 클릭하여 UCloud에 배포합니다.
다운로드 링크
| 웹사이트 | 다운로드 링크 | 비고 |
|---|---|---|
| Github Releases | https://github.com/SUC-DriverOld/MSST-WebUI/releases | 설치 파일만 포함, 모델 없음 |
| Huggingface | https://huggingface.co/Sucial/MSST-WebUI/tree/main | 설치 파일 및 모든 모델 포함 |
문서
중국어 문서는 여기를 클릭하세요. 그 외 사용자들은 docs 폴더에서 문서를 확인할 수 있습니다. 또한 deton24의 보컬 및 악기 분리 & 마스터링 가이드도 매우 유용합니다.
소스 코드를 받아서 실행하기
- 저장소 클론
git clone https://github.com/SUC-DriverOld/MSST-WebUI.git
cd MSST-WebUI
- Python 환경 생성 및 라이브러리 설치 (Python 3.10 권장):
conda create -n msst python=3.10 -y
conda activate msst
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt --only-binary=samplerate
- 라이브러리 설치 후, 요구사항 설치 후, site-packages 폴더로 이동하여 librosa\util\utils.py 파일을 열고 2185번째 줄로 이동합니다. 다음과 같이 코드를 수정하세요:
np.dtype(complex): np.dtype(np.float).type, → np.dtype(complex): np.dtype(float).type, 만약 이 작업이 어렵거나 익숙하지 않다면, 아래 명령어를 사용해 쉽게 대체할 수 있습니다.
pip uninstall librosa -y
pip install tools/webUI_for_clouds/librosa-0.9.2-py3-none-any.whl
- WebUI 실행:
python webUI.py
-
자세한 실행 인자나 클라우드 실행은 이 문서 참고
-
모델 유형이
swin_upernet일 때 다음 오류가 발생할 수 있음:ValueError: Make sure that the channel dimension of the pixel values match with the one set in the configuration. 이슈 #24 참고하세요
CLI 및 Python API
학습 및 검증
참고 자료
- [deton24's Documents] Instrumental and vocal & stems separation & mastering guide
- [KitsuneX07's ComfyMSS] ComfyMSS
- [PyQt-Fluent-Widgets] PyQt-Fluent-Widgets
- [Pyside6] PySide6 documents
- [python-audio-separator] python-audio-separator
- [Singing-Oriented MIDI Extractor] SOME
- [Ultimate Vocal Remover] Ultimate Vocal Remover
- [ZFTurbo's MSST code] Music-Source-Separation-Training
기여자 여러분께 감사드립니다
모델 제공자 분들께 감사드립니다
 |
 |
 |
 |
 |
 |
| anvuew | aufr33 | deton24 | jarredou | pcunwa | Sucial |
 |
 |
 |
 |
 |
|
| Super-YH | viperx | wesleyr36 | yxlllc | ZFturbo |