This is the code for the SpeechTokenizer presented in the SpeechTokenizer: Unified Speech Tokenizer for Speech Language Models. SpeechTokenizer is a unified speech tokenizer for speech language models, which adopts the Encoder-Decoder architecture with residual vector quantization (RVQ). Unifying semantic and acoustic tokens, SpeechTokenizer disentangles different aspects of speech information hierarchically across different RVQ layers. Specifically, the code indices that the first quantizer of RVQ outputs can be considered as semantic tokens and the output of the remaining quantizers mainly contain timbre info, which serve as supplements for the information lost by the first quantizer. We provide our models:
- A model operated at 16khz on monophonic speech trained on Librispeech with average representation across all HuBERT layers as semantic teacher.
- A model with Snake activation operated at 16khz on monophonic speech trained on Librispeech and Common Voice with average representation across all HuBERT layers as semantic teacher.
The SpeechTokenizer framework.
Welcome to try our SLMTokBench and we will also open source our USLM!
- [2024/6/9] 🔥 We released the training code of SpeechTokenizer.
- [2024/3] 🔥 We released a checkpoint of SpeechTokenizer with Snake activation trained on LibriSpeech and Common Voice.
- [2023/9/11] 🔥 We released code of soundstorm_speechtokenizer.
- [2023/9/10] 🔥 We released code and checkpoints of USLM.
- [2023/9/1] 🔥 We released code and checkpoints of SpeechTokenizer. Checkout the paper and demo.
Samples are provided on our demo page.
SpeechTokenizer requires Python>=3.8, and a reasonly recent version of PyTorch. To install SpeechTokenizer, you can run from this repository:
pip install -U speechtokenizer
# or you can clone the repo and install locally
git clone https://github.com/ZhangXInFD/SpeechTokenizer.git
cd SpeechTokenizer
pip install .
Model | Dataset | Discription |
---|---|---|
speechtokenizer_hubert_avg | LibriSpeech | Adopt average representation across all HuBERT layers as semantic teacher |
speechtokenizer_snake | LibriSpeech + Common Voice | Snake activation, average representation across all HuBERT layers |
from speechtokenizer import SpeechTokenizer
config_path = '/path/config.json'
ckpt_path = '/path/SpeechTokenizer.pt'
model = SpeechTokenizer.load_from_checkpoint(config_path, ckpt_path)
model.eval()
import torchaudio
import torch
# Load and pre-process speech waveform
wav, sr = torchaudio.load('<SPEECH_FILE_PATH>')
# monophonic checking
if wav.shape(0) > 1:
wav = wav[:1,:]
if sr != model.sample_rate:
wav = torchaudio.functional.resample(wav, sr, model.sample_rate)
wav = wav.unsqueeze(0)
# Extract discrete codes from SpeechTokenizer
with torch.no_grad():
codes = model.encode(wav) # codes: (n_q, B, T)
RVQ_1 = codes[:1, :, :] # Contain content info, can be considered as semantic tokens
RVQ_supplement = codes[1:, :, :] # Contain timbre info, complete info lost by the first quantizer
# Concatenating semantic tokens (RVQ_1) and supplementary timbre tokens and then decoding
wav = model.decode(torch.cat([RVQ_1, RVQ_supplement], axis=0))
# Decoding from RVQ-i:j tokens from the ith quantizers to the jth quantizers
wav = model.decode(codes[i: (j + 1)], st=i)
In the following section, we describe how to train a SpeechTokenizer model by using our trainer.
To train the SpeechTokenizer, the first step is to extract semantic teacher representations from raw audio waveforms. We provide an example of how to extract HuBERT representations in scripts/hubert_rep_extract.sh. We explain the arguments in the following:
--config
: Config file path. An example is provided in config/spt_base_cfg.json. You can modify thesemantic_model_path
andsemantic_model_layer
parameters in this file to change the Hubert model and the target layer.--audio_dir
: The path to the folder containing all audio files.--rep_dir
: The path to the folder storing all semantic representation files.--exts
: The file extension of the audio files. Use ',' to separate multiple extensions if they exist.--split_seed
: Random seed for splitting training set and validation set.--valid_set_size
: The size of validation set. When this number is between 0 and 1, it represents the proportion of the total dataset used for the validation set.
You can use SpeechTokenizerTrainer to train a SpeechTokenizer as follows:
from speechtokenizer import SpeechTokenizer, SpeechTokenizerTrainer
from speechtokenizer.discriminators import MultiPeriodDiscriminator, MultiScaleDiscriminator, MultiScaleSTFTDiscriminator
import json
# Load model and trainer config
with open('<CONFIG_FILE_PATH>') as f:
cfg = json.load(f)
# Initialize SpeechTokenizer
generator = SpeechTokenizer(cfg)
# Initialize the discriminators. You can add any discriminator that is not yet implemented in this repository, as long as the output format remains consistent with the discriminators in `speechtokenizer.discriminators`.
discriminators = {'mpd':MultiPeriodDiscriminator(), 'msd':MultiScaleDiscriminator(), 'mstftd':MultiScaleSTFTDiscriminator(32)}
# Initialize Trainer
trainer = SpeechTokenizerTrainer(generator=generator,
discriminators=discriminators,
cfg=cfg)
# Start training
trainer.train()
# Continue training from checkpoints
trainer.continue_train()
We provide example training scripts in scripts/train_example.sh. All arguments for SpeechTokenizerTrainer are defined in config/spt_base_cfg.json. Below, we explain some of the important arguments:
train_files
andvalid_files
: Training file path and validation file path. These files should be text files listing the paths of all audio files and their corresponding semantic representation files in the training/validation set. Each line should follow the format: "<audio_file_path>\t<semantic_file_path>". If you use scripts/hubert_rep_extract.sh to extract semantic representations, these two files will be genrated automantically.distill_type
: Use "d_axis" for D-axis distillation loss and "t_axis" for T-axis distillation loss, as mentioned in the paper.
If you want to fully follow our experimental setup, simply set semantic_model_path
in config/spt_base_cfg.json, and AUDIO_DIR
, REP_DIR
, EXTS
in scripts/hubert_rep_extract.sh, and other optional arguments , then execute the following code:
cd SpeechTokenizer
# Extact semantic representation
bash scripts/hubert_rep_extract.sh
# Train
bash scripts/train_example.sh
If you use this code or result in your paper, please cite our work as:
@misc{zhang2023speechtokenizer,
title={SpeechTokenizer: Unified Speech Tokenizer for Speech Language Models},
author={Xin Zhang and Dong Zhang and Shimin Li and Yaqian Zhou and Xipeng Qiu},
year={2023},
eprint={2308.16692},
archivePrefix={arXiv},
primaryClass={cs.CL}
}
The code in this repository is released under the Apache 2.0 license as found in the LICENSE file.