kevinwang676 commited on
Commit
4fe39bc
1 Parent(s): 051c72a

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +11 -254
README.md CHANGED
@@ -1,256 +1,13 @@
1
- <div align="center">
2
-
3
- <h1>GPT-SoVITS-WebUI</h1>
4
- A Powerful Few-shot Voice Conversion and Text-to-Speech WebUI.<br><br>
5
-
6
- [![madewithlove](https://img.shields.io/badge/made_with-%E2%9D%A4-red?style=for-the-badge&labelColor=orange)](https://github.com/RVC-Boss/GPT-SoVITS)
7
-
8
- <img src="https://counter.seku.su/cmoe?name=gptsovits&theme=r34" /><br>
9
-
10
- [![Open In Colab](https://img.shields.io/badge/Colab-F9AB00?style=for-the-badge&logo=googlecolab&color=525252)](https://colab.research.google.com/github/RVC-Boss/GPT-SoVITS/blob/main/colab_webui.ipynb)
11
- [![Licence](https://img.shields.io/badge/LICENSE-MIT-green.svg?style=for-the-badge)](https://github.com/RVC-Boss/GPT-SoVITS/blob/main/LICENSE)
12
- [![Huggingface](https://img.shields.io/badge/🤗%20-Models%20Repo-yellow.svg?style=for-the-badge)](https://huggingface.co/lj1995/GPT-SoVITS/tree/main)
13
-
14
- [**English**](./README.md) | [**中文简体**](./docs/cn/README.md) | [**日本語**](./docs/ja/README.md) | [**한국어**](./docs/ko/README.md)
15
-
16
- </div>
17
-
18
  ---
19
 
20
- ## Features:
21
-
22
- 1. **Zero-shot TTS:** Input a 5-second vocal sample and experience instant text-to-speech conversion.
23
-
24
- 2. **Few-shot TTS:** Fine-tune the model with just 1 minute of training data for improved voice similarity and realism.
25
-
26
- 3. **Cross-lingual Support:** Inference in languages different from the training dataset, currently supporting English, Japanese, and Chinese.
27
-
28
- 4. **WebUI Tools:** Integrated tools include voice accompaniment separation, automatic training set segmentation, Chinese ASR, and text labeling, assisting beginners in creating training datasets and GPT/SoVITS models.
29
-
30
- **Check out our [demo video](https://www.bilibili.com/video/BV12g4y1m7Uw) here!**
31
-
32
- Unseen speakers few-shot fine-tuning demo:
33
-
34
- https://github.com/RVC-Boss/GPT-SoVITS/assets/129054828/05bee1fa-bdd8-4d85-9350-80c060ab47fb
35
-
36
- **User guide: [简体中文](https://www.yuque.com/baicaigongchang1145haoyuangong/ib3g1e) | [English](https://rentry.co/GPT-SoVITS-guide#/)**
37
-
38
- ## Installation
39
-
40
- For users in China region, you can [click here](https://www.codewithgpu.com/i/RVC-Boss/GPT-SoVITS/GPT-SoVITS-Official) to use AutoDL Cloud Docker to experience the full functionality online.
41
-
42
- ### Tested Environments
43
-
44
- - Python 3.9, PyTorch 2.0.1, CUDA 11
45
- - Python 3.10.13, PyTorch 2.1.2, CUDA 12.3
46
- - Python 3.9, PyTorch 2.3.0.dev20240122, macOS 14.3 (Apple silicon)
47
-
48
- _Note: numba==0.56.4 requires py<3.11_
49
-
50
- ### Windows
51
-
52
- If you are a Windows user (tested with win>=10), you can directly download the [pre-packaged distribution](https://huggingface.co/lj1995/GPT-SoVITS-windows-package/resolve/main/GPT-SoVITS-beta.7z?download=true) and double-click on _go-webui.bat_ to start GPT-SoVITS-WebUI.
53
-
54
- Users in China region can download the file by clicking [here](https://www.icloud.com.cn/iclouddrive/061bfkcVJcBfsMfLF5R2XKdTQ#GPT-SoVITS-beta0217) and then selecting "Download a copy."
55
-
56
- ### Linux
57
-
58
- ```bash
59
- conda create -n GPTSoVits python=3.9
60
- conda activate GPTSoVits
61
- bash install.sh
62
- ```
63
-
64
- ### macOS
65
-
66
- **Note: The models trained with GPUs on Macs result in significantly lower quality compared to those trained on other devices, so we are temporarily using CPUs instead.**
67
-
68
- First make sure you have installed FFmpeg by running `brew install ffmpeg` or `conda install ffmpeg`, then install by using the following commands:
69
-
70
- ```bash
71
- conda create -n GPTSoVits python=3.9
72
- conda activate GPTSoVits
73
-
74
- pip install -r requirements.txt
75
- ```
76
-
77
- ### Install Manually
78
-
79
- #### Install Dependences
80
-
81
- ```bash
82
- pip install -r requirements.txt
83
- ```
84
-
85
- #### Install FFmpeg
86
-
87
- ##### Conda Users
88
-
89
- ```bash
90
- conda install ffmpeg
91
- ```
92
-
93
- ##### Ubuntu/Debian Users
94
-
95
- ```bash
96
- sudo apt install ffmpeg
97
- sudo apt install libsox-dev
98
- conda install -c conda-forge 'ffmpeg<7'
99
- ```
100
-
101
- ##### Windows Users
102
-
103
- Download and place [ffmpeg.exe](https://huggingface.co/lj1995/VoiceConversionWebUI/blob/main/ffmpeg.exe) and [ffprobe.exe](https://huggingface.co/lj1995/VoiceConversionWebUI/blob/main/ffprobe.exe) in the GPT-SoVITS root.
104
-
105
- ### Using Docker
106
-
107
- #### docker-compose.yaml configuration
108
-
109
- 0. Regarding image tags: Due to rapid updates in the codebase and the slow process of packaging and testing images, please check [Docker Hub](https://hub.docker.com/r/breakstring/gpt-sovits) for the currently packaged latest images and select as per your situation, or alternatively, build locally using a Dockerfile according to your own needs.
110
- 1. Environment Variables:
111
-
112
- - is_half: Controls half-precision/double-precision. This is typically the cause if the content under the directories 4-cnhubert/5-wav32k is not generated correctly during the "SSL extracting" step. Adjust to True or False based on your actual situation.
113
-
114
- 2. Volumes Configuration,The application's root directory inside the container is set to /workspace. The default docker-compose.yaml lists some practical examples for uploading/downloading content.
115
- 3. shm_size: The default available memory for Docker Desktop on Windows is too small, which can cause abnormal operations. Adjust according to your own situation.
116
- 4. Under the deploy section, GPU-related settings should be adjusted cautiously according to your system and actual circumstances.
117
-
118
- #### Running with docker compose
119
-
120
- ```
121
- docker compose -f "docker-compose.yaml" up -d
122
- ```
123
-
124
- #### Running with docker command
125
-
126
- As above, modify the corresponding parameters based on your actual situation, then run the following command:
127
-
128
- ```
129
- docker run --rm -it --gpus=all --env=is_half=False --volume=G:\GPT-SoVITS-DockerTest\output:/workspace/output --volume=G:\GPT-SoVITS-DockerTest\logs:/workspace/logs --volume=G:\GPT-SoVITS-DockerTest\SoVITS_weights:/workspace/SoVITS_weights --workdir=/workspace -p 9880:9880 -p 9871:9871 -p 9872:9872 -p 9873:9873 -p 9874:9874 --shm-size="16G" -d breakstring/gpt-sovits:xxxxx
130
- ```
131
-
132
- ## Pretrained Models
133
-
134
- Download pretrained models from [GPT-SoVITS Models](https://huggingface.co/lj1995/GPT-SoVITS) and place them in `GPT_SoVITS/pretrained_models`.
135
-
136
- For UVR5 (Vocals/Accompaniment Separation & Reverberation Removal, additionally), download models from [UVR5 Weights](https://huggingface.co/lj1995/VoiceConversionWebUI/tree/main/uvr5_weights) and place them in `tools/uvr5/uvr5_weights`.
137
-
138
- Users in China region can download these two models by entering the links below and clicking "Download a copy"
139
-
140
- - [GPT-SoVITS Models](https://www.icloud.com.cn/iclouddrive/056y_Xog_HXpALuVUjscIwTtg#GPT-SoVITS_Models)
141
-
142
- - [UVR5 Weights](https://www.icloud.com.cn/iclouddrive/0bekRKDiJXboFhbfm3lM2fVbA#UVR5_Weights)
143
-
144
- For Chinese ASR (additionally), download models from [Damo ASR Model](https://modelscope.cn/models/damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-pytorch/files), [Damo VAD Model](https://modelscope.cn/models/damo/speech_fsmn_vad_zh-cn-16k-common-pytorch/files), and [Damo Punc Model](https://modelscope.cn/models/damo/punc_ct-transformer_zh-cn-common-vocab272727-pytorch/files) and place them in `tools/asr/models`.
145
-
146
- For English or Japanese ASR (additionally), download models from [Faster Whisper Large V3](https://huggingface.co/Systran/faster-whisper-large-v3) and place them in `tools/asr/models`. Also, [other models](https://huggingface.co/Systran) may have the similar effect with smaller disk footprint.
147
-
148
- Users in China region can download this model by entering the links below
149
-
150
- - [Faster Whisper Large V3](https://www.icloud.com/iclouddrive/0c4pQxFs7oWyVU1iMTq2DbmLA#faster-whisper-large-v3) (clicking "Download a copy")
151
-
152
- - [Faster Whisper Large V3](https://hf-mirror.com/Systran/faster-whisper-large-v3) (HuggingFace mirror site)
153
-
154
- ## Dataset Format
155
-
156
- The TTS annotation .list file format:
157
-
158
- ```
159
- vocal_path|speaker_name|language|text
160
- ```
161
-
162
- Language dictionary:
163
-
164
- - 'zh': Chinese
165
- - 'ja': Japanese
166
- - 'en': English
167
-
168
- Example:
169
-
170
- ```
171
- D:\GPT-SoVITS\xxx/xxx.wav|xxx|en|I like playing Genshin.
172
- ```
173
-
174
- ## Todo List
175
-
176
- - [ ] **High Priority:**
177
-
178
- - [x] Localization in Japanese and English.
179
- - [x] User guide.
180
- - [x] Japanese and English dataset fine tune training.
181
-
182
- - [ ] **Features:**
183
- - [ ] Zero-shot voice conversion (5s) / few-shot voice conversion (1min).
184
- - [ ] TTS speaking speed control.
185
- - [ ] Enhanced TTS emotion control.
186
- - [ ] Experiment with changing SoVITS token inputs to probability distribution of vocabs.
187
- - [ ] Improve English and Japanese text frontend.
188
- - [ ] Develop tiny and larger-sized TTS models.
189
- - [x] Colab scripts.
190
- - [ ] Try expand training dataset (2k hours -> 10k hours).
191
- - [ ] better sovits base model (enhanced audio quality)
192
- - [ ] model mix
193
-
194
- ## (Optional) If you need, here will provide the command line operation mode
195
- Use the command line to open the WebUI for UVR5
196
- ```
197
- python tools/uvr5/webui.py "<infer_device>" <is_half> <webui_port_uvr5>
198
- ```
199
- If you can't open a browser, follow the format below for UVR processing,This is using mdxnet for audio processing
200
- ```
201
- python mdxnet.py --model --input_root --output_vocal --output_ins --agg_level --format --device --is_half_precision
202
- ```
203
- This is how the audio segmentation of the dataset is done using the command line
204
- ```
205
- python audio_slicer.py \
206
- --input_path "<path_to_original_audio_file_or_directory>" \
207
- --output_root "<directory_where_subdivided_audio_clips_will_be_saved>" \
208
- --threshold <volume_threshold> \
209
- --min_length <minimum_duration_of_each_subclip> \
210
- --min_interval <shortest_time_gap_between_adjacent_subclips>
211
- --hop_size <step_size_for_computing_volume_curve>
212
- ```
213
- This is how dataset ASR processing is done using the command line(Only Chinese)
214
- ```
215
- python tools/asr/funasr_asr.py -i <input> -o <output>
216
- ```
217
- ASR processing is performed through Faster_Whisper(ASR marking except Chinese)
218
-
219
- (No progress bars, GPU performance may cause time delays)
220
- ```
221
- python ./tools/asr/fasterwhisper_asr.py -i <input> -o <output> -l <language>
222
- ```
223
- A custom list save path is enabled
224
-
225
- ## Credits
226
-
227
- Special thanks to the following projects and contributors:
228
-
229
- ### Theoretical
230
- - [ar-vits](https://github.com/innnky/ar-vits)
231
- - [SoundStorm](https://github.com/yangdongchao/SoundStorm/tree/master/soundstorm/s1/AR)
232
- - [vits](https://github.com/jaywalnut310/vits)
233
- - [TransferTTS](https://github.com/hcy71o/TransferTTS/blob/master/models.py#L556)
234
- - [contentvec](https://github.com/auspicious3000/contentvec/)
235
- - [hifi-gan](https://github.com/jik876/hifi-gan)
236
- - [fish-speech](https://github.com/fishaudio/fish-speech/blob/main/tools/llama/generate.py#L41)
237
- ### Pretrained Models
238
- - [Chinese Speech Pretrain](https://github.com/TencentGameMate/chinese_speech_pretrain)
239
- - [Chinese-Roberta-WWM-Ext-Large](https://huggingface.co/hfl/chinese-roberta-wwm-ext-large)
240
- ### Text Frontend for Inference
241
- - [paddlespeech zh_normalization](https://github.com/PaddlePaddle/PaddleSpeech/tree/develop/paddlespeech/t2s/frontend/zh_normalization)
242
- - [LangSegment](https://github.com/juntaosun/LangSegment)
243
- ### WebUI Tools
244
- - [ultimatevocalremovergui](https://github.com/Anjok07/ultimatevocalremovergui)
245
- - [audio-slicer](https://github.com/openvpi/audio-slicer)
246
- - [SubFix](https://github.com/cronrpc/SubFix)
247
- - [FFmpeg](https://github.com/FFmpeg/FFmpeg)
248
- - [gradio](https://github.com/gradio-app/gradio)
249
- - [faster-whisper](https://github.com/SYSTRAN/faster-whisper)
250
- - [FunASR](https://github.com/alibaba-damo-academy/FunASR)
251
-
252
- ## Thanks to all contributors for their efforts
253
-
254
- <a href="https://github.com/RVC-Boss/GPT-SoVITS/graphs/contributors" target="_blank">
255
- <img src="https://contrib.rocks/image?repo=RVC-Boss/GPT-SoVITS" />
256
- </a>
 
1
+ ---
2
+ title: GPT SoVITS Emo
3
+ emoji: 🐠
4
+ colorFrom: purple
5
+ colorTo: red
6
+ sdk: gradio
7
+ sdk_version: 4.23.0
8
+ app_file: app.py
9
+ pinned: false
10
+ license: mit
 
 
 
 
 
 
 
11
  ---
12
 
13
+ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference