🎤 SoulX-Singer

Official inference code for
SoulX-Singer: Towards High-Quality Zero-Shot Singing Voice Synthesis

--- ## 🎵 Overview **SoulX-Singer** is a high-fidelity, zero-shot singing voice synthesis model that enables users to generate realistic singing voices for unseen singers. It supports **melody-conditioned (F0 contour)** and **score-conditioned (MIDI notes)** control for precise pitch, rhythm, and expression. --- ## ✨ Key Features - **🎤 Zero-Shot Singing** – Generate high-fidelity voices for unseen singers, no fine-tuning needed. - **🎵 Flexible Control Modes** – Melody (F0) and Score (MIDI) conditioning. - **📚 Large-Scale Dataset** – 42,000+ hours of aligned vocals, lyrics, notes across Mandarin, English, Cantonese. - **🧑‍🎤 Timbre Cloning** – Preserve singer identity across languages, styles, and edited lyrics. - **✏️ Singing Voice Editing** – Modify lyrics while keeping natural prosody. - **🌐 Cross-Lingual Synthesis** – High-fidelity synthesis by disentangling timbre from content. ---

Performance Radar

--- ## 🎬 Demo Examples

--- ## 📰 News - **[2026-02-06]** SoulX-Singer inference code and models released. --- ## 🚀 Quick Start ### 1. Clone Repository ```bash git clone https://github.com/Soul-AILab/SoulX-Singer.git cd SoulX-Singer ``` ### 2. Set Up Environment **1. Install Conda** (if not already installed): https://docs.conda.io/en/latest/miniconda.html **2. Create and activate a Conda environment:** ``` conda create -n soulxsinger -y python=3.10 conda activate soulxsinger ``` **3. Install dependencies:** ``` pip install -r requirements.txt ``` ⚠️ If you are in mainland China, use a PyPI mirror: ``` pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com ``` --- ### 3. Download Pretrained Models Install Hugging Face Hub if needed: ``` pip install -U huggingface_hub ``` Download the SVS model and preprocessing models: ```sh pip install -U huggingface_hub # Download the SoulX-Singer SVS model hf download Soul-AILab/SoulX-Singer --local-dir pretrained_models/SoulX-Singer # Download models required for preprocessing hf download Soul-AILab/SoulX-Singer-Preprocess --local-dir pretrained_models/SoulX-Singer-Preprocess ``` ### 4. Run the Demo Run the inference demo: ``` sh bash example/infer.sh ``` This script relies on metadata generated from the preprocessing pipeline, including vocal separation and transcription. Users should follow the steps in [preprocess](preprocess/README.md) to prepare the necessary metadata before running the demo with their own data. ## 🚧 Roadmap - [ ] 🖥️ Web-based UI for easy and interactive inference - [ ] 🌐 Online demo deployment on Hugging Face Spaces - [ ] 📊 Release the SoulX-Singer-Eval benchmark - [ ] 📚 Comprehensive tutorials and usage documentation ## 🙏 Acknowledgements Special thanks to the following open-source projects: - [F5-TTS](https://github.com/SWivid/F5-TTS) - [Amphion](https://github.com/open-mmlab/Amphion/tree/main) - [Music Source Separation Training](https://github.com/ZFTurbo/Music-Source-Separation-Training) - [Lead Vocal Separation](https://huggingface.co/becruily/mel-band-roformer-karaoke) - [Vocal Dereverberation](https://huggingface.co/anvuew/dereverb_mel_band_roformer) - [RMVPE](https://github.com/Dream-High/RMVPE) [Paraformer](https://modelscope.cn/models/iic/speech_seaco_paraformer_large_asr_nat-zh-cn-16k-common-vocab8404-pytorch) - [Parakeet-tdt-0.6b-v2](https://huggingface.co/nvidia/parakeet-tdt-0.6b-v2) - [ROSVOT](https://github.com/RickyL-2000/ROSVOT) ## 📄 License We use the Apache 2.0 license. Researchers and developers are free to use the codes and model weights of our SoulX-Singer. Check the license at [LICENSE](LICENSE) for more details. ## ⚠️ Usage Disclaimer SoulX-Singer is intended for academic research, educational purposes, and legitimate applications such as personalized singing synthesis and assistive technologies. Please note: - 🎤 Respect intellectual property, privacy, and personal consent when generating singing content. - 🚫 Do not use the model to impersonate individuals without authorization or to create deceptive audio. - ⚠️ The developers assume no liability for any misuse of this model. We advocate for the responsible development and use of AI and encourage the community to uphold safety and ethical principles. For ethics or misuse concerns, please contact us. ## 📬 Contact Us We welcome your feedback, questions, and collaboration: - **Email**: qianjiale@soulapp.cn | menghao@soulapp.cn | wangxinsheng@soulapp.cn - **Join discussions**: WeChat or Soul APP groups for technical discussions and updates:

WeChat Group QR Code