so-vits-svc/README.md

495 lines
29 KiB
Markdown
Raw Normal View History

2023-03-12 02:54:00 +00:00
# SoftVC VITS Singing Voice Conversion
2023-03-11 05:23:24 +00:00
2023-03-12 02:46:22 +00:00
[**English**](./README.md) | [**中文简体**](./README_zh_CN.md)
2023-06-14 08:11:05 +00:00
#### ✨ A studio that contains f0 curve editor, speaker mix timeline editor and other features (The purpose of the Onnx model) : [MoeVoiceStudio](https://github.com/NaruseMioShirakana/MoeVoiceStudio)
2023-05-18 05:25:25 +00:00
2023-03-20 11:07:59 +00:00
#### ✨ A fork with a greatly improved interface: [34j/so-vits-svc-fork](https://github.com/34j/so-vits-svc-fork)
2023-03-11 05:23:24 +00:00
2023-03-20 11:07:59 +00:00
#### ✨ A client supports real-time conversion: [w-okada/voice-changer](https://github.com/w-okada/voice-changer)
2023-05-23 07:37:20 +00:00
**This project is fundamentally different from Vits. Vits is TTS and this project is SVC. TTS cannot be carried out in this project, and Vits cannot carry out SVC, and the two project models are not universal.**
2023-05-14 17:15:05 +00:00
## Announcement
The project was developed to allow the developers' favorite anime characters to sing, Anything involving real people is a departure from the intent of the developer.
## Disclaimer
2023-04-11 13:24:55 +00:00
2023-05-23 07:37:20 +00:00
This project is an open source, offline project, and all members of SvcDevelopTeam and all developers and maintainers of this project (hereinafter referred to as contributors) have no control over this project. The contributor of this project has never provided any organization or individual with any form of assistance, including but not limited to data set extraction, data set processing, computing support, training support, infering, etc. Contributors to the project do not and cannot know what users are using the project for. Therefore, all AI models and synthesized audio based on the training of this project have nothing to do with the contributors of this project. All problems arising therefrom shall be borne by the user.
2023-04-11 13:24:55 +00:00
2023-05-14 17:15:05 +00:00
This project is run completely offline and cannot collect any user information or obtain user input data. Therefore, contributors to this project are not aware of all user input and models and therefore are not responsible for any user input.
This project is only a framework project, which does not have the function of speech synthesis itself, and all the functions require the user to train the model themselves. Meanwhile, there is no model attached to this project, and any secondary distributed project has nothing to do with the contributors of this project
2023-03-20 11:07:59 +00:00
## 📏 Terms of Use
# Warning: Please solve the authorization problem of the dataset on your own. You shall be solely responsible for any problems caused by the use of non-authorized datasets for training and all consequences thereof.The repository and its maintainer, svc develop team, have nothing to do with the consequences!
1. This project is established for academic exchange purposes only and is intended for communication and learning purposes. It is not intended for production environments.
2023-03-11 05:23:24 +00:00
2. Any videos based on sovits that are published on video platforms must clearly indicate in the description that they are used for voice changing and specify the input source of the voice or audio, for example, using videos or audios published by others and separating the vocals as input source for conversion, which must provide clear original video or music links. If your own voice or other synthesized voices from other commercial vocal synthesis software are used as the input source for conversion, you must also explain it in the description.
3. You shall be solely responsible for any infringement problems caused by the input source. When using other commercial vocal synthesis software as input source, please ensure that you comply with the terms of use of the software. Note that many vocal synthesis engines clearly state in their terms of use that they cannot be used for input source conversion.
2023-04-11 13:24:55 +00:00
4. It is forbidden to use the project to engage in illegal activities, religious and political activities. The project developers firmly resist the above activities. If they do not agree with this article, the use of the project is prohibited.
5. Continuing to use this project is deemed as agreeing to the relevant provisions stated in this repository README. This repository README has the obligation to persuade, and is not responsible for any subsequent problems that may arise.
6. If you use this project for any other plan, please contact and inform the author of this repository in advance. Thank you very much.
2023-03-11 05:23:24 +00:00
2023-03-20 11:07:59 +00:00
## 📝 Model Introduction
2023-03-11 05:23:24 +00:00
2023-03-16 14:57:05 +00:00
The singing voice conversion model uses SoftVC content encoder to extract source audio speech features, then the vectors are directly fed into VITS instead of converting to a text based intermediate; thus the pitch and intonations are conserved. Additionally, the vocoder is changed to [NSF HiFiGAN](https://github.com/openvpi/DiffSinger/tree/refactor/modules/nsf_hifigan) to solve the problem of sound interruption.
2023-03-11 05:23:24 +00:00
2023-05-22 15:28:53 +00:00
### 🆕 4.1-Stable Version Update Content
2023-04-15 03:33:07 +00:00
2023-05-22 15:28:53 +00:00
- Feature input is changed to [Content Vec](https://github.com/auspicious3000/contentvec) Transformer output of 12 layer, And compatible with 4.0 branches.
- Update the shallow diffusion, you can use the shallow diffusion model to improve the sound quality.
2023-05-25 15:34:51 +00:00
- Added Whisper speech encoder support
2023-05-29 16:40:29 +00:00
- Added static/dynamic sound fusion
- Added loudness embedding
2023-05-31 18:45:01 +00:00
- Added feature Retrieve from [RVC](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI)
2023-05-25 15:34:51 +00:00
2023-05-18 02:45:46 +00:00
### 🆕 Questions about compatibility with the 4.0 model
2023-05-14 13:43:53 +00:00
2023-05-18 02:45:46 +00:00
- You can support the 4.0 model by modifying the config.json of the 4.0 model, adding the speech_encoder field to the Model field of config.json, see below for details
2023-05-14 13:43:53 +00:00
```
"model": {
.........
2023-05-22 15:28:53 +00:00
"ssl_dim": 256,
2023-05-14 13:43:53 +00:00
"n_speakers": 200,
"speech_encoder":"vec256l9"
}
```
2023-05-18 02:45:46 +00:00
### 🆕 About shallow diffusion
![Diagram](shadowdiffusion.png)
2023-03-24 15:13:44 +00:00
## 💬 About Python Version
2023-04-09 03:36:55 +00:00
After conducting tests, we believe that the project runs stably on `Python 3.8.9`.
2023-03-24 15:13:44 +00:00
2023-03-20 11:07:59 +00:00
## 📥 Pre-trained Model Files
2023-03-11 05:23:24 +00:00
2023-03-12 02:46:22 +00:00
#### **Required**
2023-05-14 13:43:53 +00:00
**The following encoder needs to select one to use**
2023-05-29 16:40:29 +00:00
##### **1. If using contentvec as speech encoder(recommended)**
2023-06-04 11:13:08 +00:00
`vec768l12` and `vec256l9` require the encoder
2023-03-11 05:23:24 +00:00
- ContentVec: [checkpoint_best_legacy_500.pt](https://ibm.box.com/s/z1wgl1stco8ffooyatzdwsqn2psd9lrr)
2023-05-14 13:43:53 +00:00
- Place it under the `pretrain` directory
2023-03-11 05:23:24 +00:00
2023-06-03 15:54:28 +00:00
Or download the following ContentVec, which is only 199MB in size but has the same effect:
- contentvec [hubert_base.pt](https://huggingface.co/lj1995/VoiceConversionWebUI/resolve/main/hubert_base.pt)
- Change the file name to `checkpoint_best_legacy_500.pt` and place it in the `pretrain` directory
2023-03-11 05:23:24 +00:00
```shell
# contentvec
2023-05-14 13:43:53 +00:00
wget -P pretrain/ http://obs.cstcloud.cn/share/obs/sankagenkeshi/checkpoint_best_legacy_500.pt
2023-03-11 05:23:24 +00:00
# Alternatively, you can manually download and place it in the hubert directory
```
2023-05-25 15:34:51 +00:00
##### **2. If hubertsoft is used as the speech encoder**
2023-05-14 13:43:53 +00:00
- soft vc hubert[hubert-soft-0d54a1f4.pt](https://github.com/bshall/hubert/releases/download/v0.1/hubert-soft-0d54a1f4.pt)
- Place it under the `pretrain` directory
2023-05-25 13:37:36 +00:00
##### **3. If whisper-ppg as the encoder**
2023-06-04 11:13:08 +00:00
- download model at [medium.pt](https://openaipublic.azureedge.net/main/whisper/models/345ae4da62f9b3d59415adc60127b97c714f32e89e936602e85993674d08dcb1/medium.pt), the model fits `whisper-ppg`
- or download model at [large-v2.pt](https://openaipublic.azureedge.net/main/whisper/models/81f7c96c852ee8fc832187b0132e569d6c3065a3252ed18e56effd0b6a73e524/large-v2.pt), the model fits `whisper-ppg-large`
2023-05-25 15:34:51 +00:00
- Place it under the `pretrain` director
2023-06-01 18:15:42 +00:00
##### **4. If cnhubertlarge as the encoder**
- download model at [chinese-hubert-large-fairseq-ckpt.pt](https://huggingface.co/TencentGameMate/chinese-hubert-large/resolve/main/chinese-hubert-large-fairseq-ckpt.pt)
- Place it under the `pretrain` director
2023-06-01 18:44:18 +00:00
##### **5. If dphubert as the encoder**
- download model at [DPHuBERT-sp0.75.pth](https://huggingface.co/pyf98/DPHuBERT/resolve/main/DPHuBERT-sp0.75.pth)
- Place it under the `pretrain` director
2023-06-07 11:22:47 +00:00
##### **6. If WavLM is used as the encoder**
- download model at [WavLM-Base+.pt](https://valle.blob.core.windows.net/share/wavlm/WavLM-Base+.pt?sv=2020-08-04&st=2023-03-01T07%3A51%3A05Z&se=2033-03-02T07%3A51%3A00Z&sr=c&sp=rl&sig=QJXmSJG9DbMKf48UDIU1MfzIro8HQOf3sqlNXiflY1I%3D), the model fits `wavlmbase+`
- Place it under the `pretrain` director
##### **7. If OnnxHubert/ContentVec as the encoder**
2023-05-29 16:40:29 +00:00
- download model at [MoeSS-SUBModel](https://huggingface.co/NaruseMioShirakana/MoeSS-SUBModel/tree/main)
2023-05-25 13:37:36 +00:00
- Place it under the `pretrain` directory
2023-05-22 16:20:37 +00:00
#### **List of Encoders**
- "vec768l12"
- "vec256l9"
- "vec256l9-onnx"
- "vec256l12-onnx"
- "vec768l9-onnx"
- "vec768l12-onnx"
- "hubertsoft-onnx"
- "hubertsoft"
2023-05-25 13:37:36 +00:00
- "whisper-ppg"
2023-06-01 18:15:42 +00:00
- "cnhubertlarge"
2023-06-01 18:44:18 +00:00
- "dphubert"
2023-06-04 11:13:08 +00:00
- "whisper-ppg-large"
2023-06-09 11:10:29 +00:00
- "wavlmbase+"
2023-05-22 16:20:37 +00:00
2023-03-12 02:46:22 +00:00
#### **Optional(Strongly recommend)**
- Pre-trained model files: `G_0.pth` `D_0.pth`
- Place them under the `logs/44k` directory
2023-05-18 02:45:46 +00:00
- Diffusion model pretraining base model file: `model_0.pt`
- Put it in the `logs/44k/diffusion` directory
2023-05-21 06:57:59 +00:00
Get Sovits Pre-trained model from svc-develop-team(TBD) or anywhere else.
Diffusion model references [Diffusion-SVC](https://github.com/CNChTu/Diffusion-SVC) diffusion model. The pre-trained diffusion model is universal with the DDSP-SVC's. You can go to [Diffusion-SVC](https://github.com/CNChTu/Diffusion-SVC) to get the pre-trained diffusion model.
2023-03-12 02:46:22 +00:00
2023-03-12 02:53:36 +00:00
Although the pretrained model generally does not cause any copyright problems, please pay attention to it. For example, ask the author in advance, or the author has indicated the feasible use in the description clearly.
2023-04-08 17:07:12 +00:00
#### **Optional(Select as Required)**
2023-05-18 02:45:46 +00:00
If you are using the `NSF-HIFIGAN enhancer` or `shallow diffusion`, you will need to download the pre-trained NSF-HIFIGAN model, or not if you do not need it.
2023-04-08 17:07:12 +00:00
- Pre-trained NSF-HIFIGAN Vocoder: [nsf_hifigan_20221211.zip](https://github.com/openvpi/vocoders/releases/download/nsf-hifigan-v1/nsf_hifigan_20221211.zip)
2023-04-09 03:36:55 +00:00
- Unzip and place the four files under the `pretrain/nsf_hifigan` directory
2023-04-08 17:07:12 +00:00
```shell
# nsf_hifigan
2023-05-14 13:43:53 +00:00
wget -P pretrain/ https://github.com/openvpi/vocoders/releases/download/nsf-hifigan-v1/nsf_hifigan_20221211.zip
2023-05-23 07:37:20 +00:00
\unzip -od pretrain/nsf_hifigan pretrain/nsf_hifigan_20221211.zip
2023-04-08 17:07:12 +00:00
# Alternatively, you can manually download and place it in the pretrain/nsf_hifigan directory
# URLhttps://github.com/openvpi/vocoders/releases/tag/nsf-hifigan-v1
```
2023-03-20 11:07:59 +00:00
## 📊 Dataset Preparation
2023-03-11 05:23:24 +00:00
Simply place the dataset in the `dataset_raw` directory with the following file structure.
2023-03-24 08:59:47 +00:00
```
2023-03-11 05:23:24 +00:00
dataset_raw
├───speaker0
│ ├───xxx1-xxx1.wav
│ ├───...
│ └───Lxx-0xx8.wav
└───speaker1
├───xx2-0xxx2.wav
├───...
└───xxx7-xxx007.wav
```
2023-03-24 08:59:47 +00:00
You can customize the speaker name.
```
dataset_raw
└───suijiSUI
├───1.wav
├───...
└───25788785-20221210-200143-856_01_(Vocals)_0_0.wav
```
2023-03-20 11:07:59 +00:00
## 🛠️ Preprocessing
2023-03-11 05:23:24 +00:00
2023-04-09 03:41:03 +00:00
### 0. Slice audio
2023-04-09 03:36:55 +00:00
Slice to `5s - 15s`, a bit longer is no problem. Too long may lead to `torch.cuda.OutOfMemoryError` during training or even pre-processing.
By using [audio-slicer-GUI](https://github.com/flutydeer/audio-slicer) or [audio-slicer-CLI](https://github.com/openvpi/audio-slicer)
2023-04-09 03:41:03 +00:00
In general, only the `Minimum Interval` needs to be adjusted. For statement audio it usually remains default. For singing audio it can be adjusted to `100` or even `50`.
2023-04-09 03:36:55 +00:00
After slicing, delete audio that is too long and too short.
2023-05-25 13:48:39 +00:00
**If you use whisper-ppg encoder for training,the wav must shorter than 30s.**
2023-04-09 03:41:03 +00:00
### 1. Resample to 44100Hz and mono
2023-03-11 05:23:24 +00:00
```shell
python resample.py
```
2023-05-25 15:34:51 +00:00
#### Attention
2023-06-02 04:41:25 +00:00
Although this project has the script resample.py for resampling, to mono and loudness matching, the default loudness matching is to match to 0db. This may cause damage to the sound quality. While python's loudness matching package pyloudnorm is unable to limit the level, this results in a burst. Therefore, it is suggested to consider using professional sound processing software such as `adobe audition` for loudness matching processing. If you have already used other software for loudness matching, run the command with the argument `--skip_loudnorm`:
2023-05-25 15:34:51 +00:00
2023-06-02 04:41:25 +00:00
```shell
python resample.py --skip_loudnorm
2023-05-25 15:34:51 +00:00
```
2023-04-09 03:41:03 +00:00
### 2. Automatically split the dataset into training and validation sets, and generate configuration files.
2023-03-11 05:23:24 +00:00
```shell
2023-05-25 15:34:51 +00:00
python preprocess_flist_config.py --speech_encoder vec768l12
2023-03-11 05:23:24 +00:00
```
2023-06-07 11:22:47 +00:00
speech_encoder has the following options
2023-05-14 13:43:53 +00:00
```
vec768l12
vec256l9
hubertsoft
2023-05-25 13:43:02 +00:00
whisper-ppg
2023-06-01 18:15:42 +00:00
cnhubertlarge
2023-06-01 18:44:18 +00:00
dphubert
2023-06-04 11:13:08 +00:00
whisper-ppg-large
2023-06-09 11:10:29 +00:00
wavlmbase+
2023-05-14 13:43:53 +00:00
```
If the speech_encoder argument is omitted, the default value is vec768l12
2023-05-29 16:40:29 +00:00
**Use loudness embedding**
2023-05-29 22:35:53 +00:00
Add `--vol_aug` if you want to enable loudness embedding:
```shell
python preprocess_flist_config.py --speech_encoder vec768l12 --vol_aug
```
After enabling loudness embedding, the trained model will match the loudness of the input source; otherwise, it will be the loudness of the training set.
2023-05-29 16:40:29 +00:00
2023-05-30 10:07:07 +00:00
#### You can modify some parameters in the generated config.json and diffusion.yaml
* `keep_ckpts`: Keep the last `keep_ckpts` models during training. Set to `0` will keep them all. Default is `3`.
* `all_in_mem`, `cache_all_data`: Load all dataset to RAM. It can be enabled when the disk IO of some platforms is too low and the system memory is **much larger** than your dataset.
* `batch_size`: The amount of data loaded to the GPU for a single training session can be adjusted to a size lower than the video memory capacity.
2023-06-02 12:18:16 +00:00
* `vocoder_name` : Select a vocoder. The default is `nsf-hifigan`.
2023-05-30 10:07:07 +00:00
2023-06-02 12:18:16 +00:00
##### **List of Vocoders**
```
nsf-hifigan
nsf-snake-hifigan
```
2023-05-30 10:07:07 +00:00
2023-04-09 03:41:03 +00:00
### 3. Generate hubert and f0
2023-03-11 05:23:24 +00:00
```shell
2023-05-14 13:43:53 +00:00
python preprocess_hubert_f0.py --f0_predictor dio
```
f0_predictor has four options
```
crepe
dio
pm
harvest
2023-03-11 05:23:24 +00:00
```
2023-05-14 13:43:53 +00:00
If the training set is too noisy, use crepe to handle f0
If the f0_predictor parameter is omitted, the default value is dio
2023-05-18 02:45:46 +00:00
If you want shallow diffusion (optional), you need to add the --use_diff parameter, for example
```shell
python preprocess_hubert_f0.py --f0_predictor dio --use_diff
```
2023-03-11 05:23:24 +00:00
After completing the above steps, the dataset directory will contain the preprocessed data, and the dataset_raw folder can be deleted.
2023-03-20 11:07:59 +00:00
## 🏋️‍♀️ Training
2023-03-11 05:23:24 +00:00
2023-05-18 02:45:46 +00:00
### Diffusion Model (optional)
If the shallow diffusion function is needed, the diffusion model needs to be trained. The diffusion model training method is as follows:
```shell
python train_diff.py -c configs/diffusion.yaml
```
### Sovits Model
2023-03-11 05:23:24 +00:00
```shell
python train.py -c configs/config.json -m 44k
```
2023-05-18 02:45:46 +00:00
After the model training, the model file is saved in the directory `logs/44k`, and the diffusion model is stored under `logs/44k/diffusion`
2023-03-20 11:07:59 +00:00
## 🤖 Inference
2023-03-11 05:23:24 +00:00
Use [inference_main.py](https://github.com/svc-develop-team/so-vits-svc/blob/4.0/inference_main.py)
```shell
# Example
python inference_main.py -m "logs/44k/G_30400.pth" -c "configs/config.json" -n "君の知らない物語-src.wav" -t 0 -s "nen"
```
Required parameters:
2023-04-05 11:01:30 +00:00
- `-m` | `--model_path`: path to the model.
- `-c` | `--config_path`: path to the configuration file.
- `-n` | `--clean_names`: a list of wav file names located in the raw folder.
- `-t` | `--trans`: pitch adjustment, supports positive and negative (semitone) values.
- `-s` | `--spk_list`: target speaker name for synthesis.
- `-cl` | `--clip`: voice forced slicing, set to 0 to turn off(default), duration in seconds.
2023-03-11 05:23:24 +00:00
Optional parameters: see the next section
2023-04-05 11:01:30 +00:00
- `-lg` | `--linear_gradient`: The cross fade length of two audio slices in seconds. If there is a discontinuous voice after forced slicing, you can adjust this value. Otherwise, it is recommended to use the default value of 0.
2023-05-13 13:04:59 +00:00
- `-f0p` | `--f0_predictor`: Select F0 predictor, can select crepe,pm,dio,harvest, default pm(note: crepe is original F0 meaning pooling)
2023-04-05 11:01:30 +00:00
- `-a` | `--auto_predict_f0`: automatic pitch prediction for voice conversion, do not enable this when converting songs as it can cause serious pitch issues.
2023-05-31 18:45:01 +00:00
- `-cm` | `--cluster_model_path`: Cluster model or feature retrieval index path, if there is no training cluster or feature retrieval, fill in at will.
- `-cr` | `--cluster_infer_ratio`: The proportion of clustering scheme or feature retrieval ranges from 0 to 1. If there is no training clustering model or feature retrieval, the default is 0.
2023-04-09 03:36:55 +00:00
- `-eh` | `--enhance`: Whether to use NSF_HIFIGAN enhancer, this option has certain effect on sound quality enhancement for some models with few training sets, but has negative effect on well-trained models, so it is turned off by default.
2023-05-29 16:40:29 +00:00
- `-shd` | `--shallow_diffusion`: Whether to use shallow diffusion, which can solve some electrical sound problems after use. This option is turned off by default. When this option is enabled, NSF_HIFIGAN intensifier will be disabled
- `-usm` | `--use_spk_mix`: whether to use dynamic voice/merge their role
2023-05-29 17:48:41 +00:00
- `-lea` | `--loudness_envelope_adjustment`The input source loudness envelope replaces the output loudness envelope fusion ratio. The closer to 1, the more the output loudness envelope is used
2023-05-31 18:45:01 +00:00
- `-fr` | `--feature_retrieval`Whether to use feature retrieval? If clustering model is used, it will be disabled, and cm and cr parameters will become the index path and mixing ratio of feature retrieval
2023-05-29 16:40:29 +00:00
2023-05-23 07:37:20 +00:00
Shallow diffusion settings:
2023-05-29 16:40:29 +00:00
- `-dm` | `--diffusion_model_path`: Diffusion model path
- `-dc` | `--diffusion_config_path`: Diffusion model profile path
- `-ks` | `--k_step`: The larger the number of diffusion steps, the closer it is to the result of the diffusion model. The default is 100
- `-od` | `--only_diffusion`: Only diffusion mode, which does not load the sovits model to the diffusion model inference
2023-05-29 17:48:41 +00:00
- `-se` | `--second_encoding`Secondary encoding, secondary coding of the original audio before shallow diffusion, mystery options, sometimes good, sometimes bad
2023-05-25 15:42:03 +00:00
### Attention
2023-05-31 18:45:01 +00:00
If reasoning using `whisper-ppg` speech encoder, you need to set `--clip` to 25 and `-lg` to 1. Otherwise it will fail to reason properly.
2023-05-25 15:42:03 +00:00
2023-03-20 11:07:59 +00:00
## 🤔 Optional Settings
2023-03-11 05:23:24 +00:00
If the results from the previous section are satisfactory, or if you didn't understand what is being discussed in the following section, you can skip it, and it won't affect the model usage. (These optional settings have a relatively small impact, and they may have some effect on certain specific data, but in most cases, the difference may not be noticeable.)
### Automatic f0 prediction
During the 4.0 model training, an f0 predictor is also trained, which can be used for automatic pitch prediction during voice conversion. However, if the effect is not good, manual pitch prediction can be used instead. But please do not enable this feature when converting singing voice as it may cause serious pitch shifting!
2023-04-04 14:44:55 +00:00
- Set `auto_predict_f0` to true in inference_main.
2023-03-11 05:23:24 +00:00
### Cluster-based timbre leakage control
Introduction: The clustering scheme can reduce timbre leakage and make the trained model sound more like the target's timbre (although this effect is not very obvious), but using clustering alone will lower the model's clarity (the model may sound unclear). Therefore, this model adopts a fusion method to linearly control the proportion of clustering and non-clustering schemes. In other words, you can manually adjust the ratio between "sounding like the target's timbre" and "being clear and articulate" to find a suitable trade-off point.
The existing steps before clustering do not need to be changed. All you need to do is to train an additional clustering model, which has a relatively low training cost.
- Training process:
2023-04-09 03:36:55 +00:00
- Train on a machine with good CPU performance. According to my experience, it takes about 4 minutes to train each speaker on a Tencent Cloud machine with 6-core CPU.
- Execute `python cluster/train_cluster.py`. The output model will be saved in `logs/44k/kmeans_10000.pt`.
2023-05-18 13:16:25 +00:00
- The clustering model can currently be trained using the gpu by executing `python cluster/train_cluster.py --gpu`
2023-03-11 05:23:24 +00:00
- Inference process:
2023-04-09 03:36:55 +00:00
- Specify `cluster_model_path` in `inference_main.py`.
- Specify `cluster_infer_ratio` in `inference_main.py`, where `0` means not using clustering at all, `1` means only using clustering, and usually `0.5` is sufficient.
2023-03-11 05:23:24 +00:00
2023-05-31 18:45:01 +00:00
### Feature retrieval
2023-06-04 01:50:20 +00:00
Introduction: As with the clustering scheme, the timbre leakage can be reduced, the character is slightly better than clustering, but it will reduce the reasoning speed, using the fusion method, can linearly control the proportion of feature retrieval and non-feature retrieval.
2023-05-31 18:45:01 +00:00
- Training process
First, it needs to be executed after generating hubert and f0
```shell
python train_index.py -c configs/config.json
```
The output of the model will be in `logs/44k/feature_and_index.pkl`
- Inference process
- The `--feature_retrieval` needs to be formulated first, and the clustering mode automatically switches to the feature retrieval mode.
- Specify `cluster_model_path` in `inference_main.py`.
- Specify `cluster_infer_ratio` in `inference_main.py`, where `0` means not using feature retrieval at all, `1` means only using feature retrieval, and usually `0.5` is sufficient.
2023-05-23 07:37:20 +00:00
### [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/svc-develop-team/so-vits-svc/blob/4.1-Stable/sovits4_for_colab.ipynb) [sovits4_for_colab.ipynb](https://colab.research.google.com/github/svc-develop-team/so-vits-svc/blob/4.1-Stable/sovits4_for_colab.ipynb)
2023-03-12 03:24:13 +00:00
2023-05-25 06:11:11 +00:00
## 🗜️ Model strip
The generated model contains data that is needed for further training. If you confirm that the model is final and not be used in further training, it is safe to strip these data to get smaller file size (about 1/3).
```shell
# Example
python compress_model.py -c="configs/config.json" -i="logs/44k/G_30400.pth" -o="logs/44k/release.pth"
```
2023-05-29 16:40:29 +00:00
## 👨‍🔧 Timbre mixing
### Stable Timbre mixing
**Refer to `webui.py` file for stable Timbre mixing of the gadget/lab feature.**
Introduction: This function can combine multiple sound models into one sound model (convex combination or linear combination of multiple model parameters) to create sound lines that do not exist in reality
**Note:**
1. This function only supports single-speaker models
2. If the multi-speaker model is forced to be used, it is necessary to ensure that the number of speakers in multiple models is the same, so that the voices under the same SpaekerID can be mixed
3. Ensure that the model fields in config.json of all models to be mixed are the same
4. The output hybrid model can use any config.json of the model to be synthesized, but the clustering model will not be used
5. When batch uploading models, it is best to put the models into a folder and upload them together after selecting them
6. It is suggested to adjust the mixing ratio between 0 and 100, or to other numbers, but unknown effects will occur in the linear combination mode
7. After mixing, the file named output.pth will be saved in the root directory of the project
8. Convex combination mode will perform Softmax to add the mix ratio to 1, while linear combination mode will not
### Dynamic timbre mixing
**Refer to the `spkmix.py` file for an introduction to dynamic timbre mixing**
Character mix track writing rules:
2023-05-29 17:48:41 +00:00
2023-05-29 16:40:29 +00:00
Role ID: \[\[Start time 1, end time 1, start value 1, start value 1], [Start time 2, end time 2, start value 2]]
2023-05-29 17:48:41 +00:00
2023-05-29 16:40:29 +00:00
The start time must be the same as the end time of the previous one. The first start time must be 0, and the last end time must be 1 (time ranges from 0 to 1).
2023-05-29 17:48:41 +00:00
2023-05-29 16:40:29 +00:00
All roles must be filled in. For unused roles, fill \[\[0., 1., 0., 0.]]
2023-05-29 17:48:41 +00:00
The fusion value can be filled in arbitrarily, and the linear change from the start value to the end value within the specified period of time. The
internal linear combination will be automatically guaranteed to be 1 (convex combination condition), so it can be used safely
2023-05-29 16:40:29 +00:00
Use the `--use_spk_mix` parameter when reasoning to enable dynamic timbre mixing
2023-03-20 11:07:59 +00:00
## 📤 Exporting to Onnx
2023-03-11 05:23:24 +00:00
Use [onnx_export.py](https://github.com/svc-develop-team/so-vits-svc/blob/4.0/onnx_export.py)
2023-03-16 14:57:05 +00:00
- Create a folder named `checkpoints` and open it
- Create a folder in the `checkpoints` folder as your project folder, naming it after your project, for example `aziplayer`
- Rename your model as `model.pth`, the configuration file as `config.json`, and place them in the `aziplayer` folder you just created
2023-05-18 05:19:48 +00:00
- Modify `"NyaruTaffy"` in `path = "NyaruTaffy"` in [onnx_export.py](https://github.com/svc-develop-team/so-vits-svc/blob/4.0/onnx_export.py) to your project name, `path = "aziplayer"`onnx_export_speaker_mix makes you can mix speaker's voice
2023-03-16 14:57:05 +00:00
- Run [onnx_export.py](https://github.com/svc-develop-team/so-vits-svc/blob/4.0/onnx_export.py)
2023-03-11 05:23:24 +00:00
- Wait for it to finish running. A `model.onnx` will be generated in your project folder, which is the exported model.
2023-04-09 03:36:55 +00:00
Note: For Hubert Onnx models, please use the models provided by MoeSS. Currently, they cannot be exported on their own (Hubert in fairseq has many unsupported operators and things involving constants that can cause errors or result in problems with the input/output shape and results when exported.)
2023-03-11 05:23:24 +00:00
2023-03-24 08:59:47 +00:00
## ☀️ Previous contributors
2023-03-22 13:04:52 +00:00
For some reason the author deleted the original repository. Because of the negligence of the organization members, the contributor list was cleared because all files were directly reuploaded to this repository at the beginning of the reconstruction of this repository. Now add a previous contributor list to README.md.
*Some members have not listed according to their personal wishes.*
<table>
<tr>
<td align="center"><a href="https://github.com/MistEO"><img src="https://avatars.githubusercontent.com/u/18511905?v=4" width="100px;" alt=""/><br /><sub><b>MistEO</b></sub></a><br /></td>
<td align="center"><a href="https://github.com/XiaoMiku01"><img src="https://avatars.githubusercontent.com/u/54094119?v=4" width="100px;" alt=""/><br /><sub><b>XiaoMiku01</b></sub></a><br /></td>
<td align="center"><a href="https://github.com/ForsakenRei"><img src="https://avatars.githubusercontent.com/u/23041178?v=4" width="100px;" alt=""/><br /><sub><b>しぐれ</b></sub></a><br /></td>
<td align="center"><a href="https://github.com/TomoGaSukunai"><img src="https://avatars.githubusercontent.com/u/25863522?v=4" width="100px;" alt=""/><br /><sub><b>TomoGaSukunai</b></sub></a><br /></td>
<td align="center"><a href="https://github.com/Plachtaa"><img src="https://avatars.githubusercontent.com/u/112609742?v=4" width="100px;" alt=""/><br /><sub><b>Plachtaa</b></sub></a><br /></td>
<td align="center"><a href="https://github.com/zdxiaoda"><img src="https://avatars.githubusercontent.com/u/45501959?v=4" width="100px;" alt=""/><br /><sub><b>zd小达</b></sub></a><br /></td>
<td align="center"><a href="https://github.com/Archivoice"><img src="https://avatars.githubusercontent.com/u/107520869?v=4" width="100px;" alt=""/><br /><sub><b>凍聲響世</b></sub></a><br /></td>
</tr>
</table>
2023-03-20 11:07:59 +00:00
## 📚 Some legal provisions for reference
2023-03-11 05:23:24 +00:00
2023-03-22 12:47:48 +00:00
#### Any country, region, organization, or individual using this project must comply with the following laws.
2023-03-11 05:23:24 +00:00
#### 《民法典》
##### 第一千零一十九条
2023-04-04 14:44:55 +00:00
任何组织或者个人不得以丑化、污损,或者利用信息技术手段伪造等方式侵害他人的肖像权。未经肖像权人同意,不得制作、使用、公开肖像权人的肖像,但是法律另有规定的除外。未经肖像权人同意,肖像作品权利人不得以发表、复制、发行、出租、展览等方式使用或者公开肖像权人的肖像。对自然人声音的保护,参照适用肖像权保护的有关规定。
2023-03-11 05:23:24 +00:00
##### 第一千零二十四条
2023-03-12 02:46:22 +00:00
【名誉权】民事主体享有名誉权。任何组织或者个人不得以侮辱、诽谤等方式侵害他人的名誉权。
2023-03-11 05:23:24 +00:00
##### 第一千零二十七条
2023-04-04 14:44:55 +00:00
【作品侵害名誉权】行为人发表的文学、艺术作品以真人真事或者特定人为描述对象,含有侮辱、诽谤内容,侵害他人名誉权的,受害人有权依法请求该行为人承担民事责任。行为人发表的文学、艺术作品不以特定人为描述对象,仅其中的情节与该特定人的情况相似的,不承担民事责任。
2023-03-22 12:47:48 +00:00
#### 《[中华人民共和国宪法](http://www.gov.cn/guoqing/2018-03/22/content_5276318.htm)》
#### 《[中华人民共和国刑法](http://gongbao.court.gov.cn/Details/f8e30d0689b23f57bfc782d21035c3.html?sw=%E4%B8%AD%E5%8D%8E%E4%BA%BA%E6%B0%91%E5%85%B1%E5%92%8C%E5%9B%BD%E5%88%91%E6%B3%95)》
2023-03-22 13:04:52 +00:00
#### 《[中华人民共和国民法典](http://gongbao.court.gov.cn/Details/51eb6750b8361f79be8f90d09bc202.html)》
2023-03-24 12:22:52 +00:00
## 💪 Thanks to all contributors for their efforts
2023-03-24 12:25:15 +00:00
<a href="https://github.com/svc-develop-team/so-vits-svc/graphs/contributors" target="_blank">
<img src="https://contrib.rocks/image?repo=svc-develop-team/so-vits-svc" />
</a>