Automatic Speech Recognition
Transformers
Safetensors
DiCoW
speech
whisper
multilingual
speaker-diarization
meeting-transcription
target-speaker-asr
BUT-FIT
custom_code
Instructions to use BUT-FIT/DiCoW_v3_3_large with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use BUT-FIT/DiCoW_v3_3_large with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("automatic-speech-recognition", model="BUT-FIT/DiCoW_v3_3_large", trust_remote_code=True)# Load model directly from transformers import AutoModelForSpeechSeq2Seq model = AutoModelForSpeechSeq2Seq.from_pretrained("BUT-FIT/DiCoW_v3_3_large", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
| from typing import Optional, Union | |
| import torch | |
| import torch.utils.checkpoint | |
| import torch.utils.checkpoint | |
| from torch.nn import CrossEntropyLoss | |
| from transformers import Cache | |
| from transformers.modeling_outputs import Seq2SeqLMOutput, Seq2SeqModelOutput | |
| from transformers.models.whisper.modeling_whisper import ( | |
| WhisperForConditionalGeneration, | |
| shift_tokens_right, | |
| WhisperModel | |
| ) | |
| from transformers.utils import logging | |
| from .config import DiCoWConfig | |
| from .encoder import DiCoWEncoder | |
| from .generation import DiCoWGenerationMixin | |
| logging.set_verbosity_debug() | |
| logger = logging.get_logger("transformers") | |
| class DiCoW(WhisperModel): | |
| def __init__(self, config: DiCoWConfig): | |
| super().__init__(config) | |
| self.encoder = DiCoWEncoder(config) | |
| self.post_init() | |
| def forward( | |
| self, | |
| input_features: Optional[torch.FloatTensor] = None, | |
| attention_mask: Optional[torch.LongTensor] = None, | |
| stno_mask: Optional[torch.FloatTensor] = None, | |
| decoder_input_ids: Optional[torch.LongTensor] = None, | |
| decoder_attention_mask: Optional[torch.LongTensor] = None, | |
| head_mask: Optional[torch.Tensor] = None, | |
| decoder_head_mask: Optional[torch.Tensor] = None, | |
| cross_attn_head_mask: Optional[torch.Tensor] = None, | |
| encoder_outputs: Optional[tuple[tuple[torch.FloatTensor]]] = None, | |
| past_key_values: Optional[Cache] = None, | |
| decoder_inputs_embeds: Optional[tuple[torch.FloatTensor]] = None, | |
| decoder_position_ids: Optional[tuple[torch.LongTensor]] = None, | |
| use_cache: Optional[bool] = None, | |
| output_attentions: Optional[bool] = None, | |
| output_hidden_states: Optional[bool] = None, | |
| return_dict: Optional[bool] = None, | |
| cache_position: Optional[torch.LongTensor] = None, | |
| enrollments = None | |
| ) -> Union[tuple[torch.Tensor], Seq2SeqModelOutput]: | |
| output_attentions = output_attentions if output_attentions is not None else self.config.output_attentions | |
| output_hidden_states = ( | |
| output_hidden_states if output_hidden_states is not None else self.config.output_hidden_states | |
| ) | |
| use_cache = use_cache if use_cache is not None else self.config.use_cache | |
| return_dict = return_dict if return_dict is not None else self.config.use_return_dict | |
| if encoder_outputs is None: | |
| input_features = self._mask_input_features(input_features, attention_mask=attention_mask) | |
| encoder_outputs = self.encoder( | |
| input_features, | |
| output_attentions=output_attentions, | |
| output_hidden_states=output_hidden_states, | |
| head_mask=head_mask, | |
| return_dict=return_dict, | |
| stno_mask=stno_mask, | |
| enrollments=enrollments | |
| ) | |
| # If the user passed a tuple for encoder_outputs, we wrap it in a BaseModelOutput when return_dict=True | |
| # elif return_dict and not isinstance(encoder_outputs, BaseModelOutput): | |
| # raise ValueError("encoder_outputs should be of type BaseModelOutput when return_dict=True.") | |
| # decoder outputs consists of (dec_features, past_key_value, dec_hidden, dec_attn) | |
| decoder_outputs = self.decoder( | |
| input_ids=decoder_input_ids, | |
| attention_mask=decoder_attention_mask, | |
| encoder_hidden_states=encoder_outputs[0], | |
| head_mask=decoder_head_mask, | |
| cross_attn_head_mask=cross_attn_head_mask, | |
| past_key_values=past_key_values, | |
| inputs_embeds=decoder_inputs_embeds, | |
| position_ids=decoder_position_ids, | |
| use_cache=use_cache, | |
| output_attentions=output_attentions, | |
| output_hidden_states=output_hidden_states, | |
| return_dict=return_dict, | |
| cache_position=cache_position, | |
| ) | |
| if not return_dict: | |
| return decoder_outputs + encoder_outputs | |
| return Seq2SeqModelOutput( | |
| last_hidden_state=decoder_outputs.last_hidden_state, | |
| past_key_values=decoder_outputs.past_key_values, | |
| decoder_hidden_states=decoder_outputs.hidden_states, | |
| decoder_attentions=decoder_outputs.attentions, | |
| cross_attentions=decoder_outputs.cross_attentions, | |
| encoder_last_hidden_state=encoder_outputs.last_hidden_state, | |
| encoder_hidden_states=encoder_outputs.hidden_states, | |
| encoder_attentions=encoder_outputs.attentions, | |
| ) | |
| class DiCoWForConditionalGeneration(DiCoWGenerationMixin, WhisperForConditionalGeneration): | |
| config_class = DiCoWConfig | |
| def __init__(self, config: DiCoWConfig): | |
| super().__init__(config) | |
| self.model = DiCoW(config) | |
| self.encoder_logits = None | |
| self.tokenizer = None | |
| self.stno_mask = None | |
| self.stno_mask_seek = None | |
| self.post_init() | |
| def set_tokenizer(self, tokenizer): | |
| self.tokenizer = tokenizer | |
| def get_enc_logits(self, hidden_states): | |
| encoder = self.model.get_encoder() | |
| hidden_states = encoder.possibly_update_last_hidden_states(hidden_states) | |
| logits = encoder.lm_head(hidden_states) | |
| return logits | |
| def forward( | |
| self, | |
| input_features: Optional[torch.FloatTensor] = None, | |
| attention_mask: Optional[torch.LongTensor] = None, | |
| stno_mask: Optional[torch.FloatTensor] = None, | |
| decoder_input_ids: Optional[torch.LongTensor] = None, | |
| decoder_attention_mask: Optional[torch.LongTensor] = None, | |
| head_mask: Optional[torch.Tensor] = None, | |
| decoder_head_mask: Optional[torch.Tensor] = None, | |
| cross_attn_head_mask: Optional[torch.Tensor] = None, | |
| encoder_outputs: Optional[tuple[tuple[torch.FloatTensor]]] = None, | |
| past_key_values: Optional[Cache] = None, | |
| decoder_inputs_embeds: Optional[tuple[torch.FloatTensor]] = None, | |
| decoder_position_ids: Optional[tuple[torch.LongTensor]] = None, | |
| labels: Optional[torch.LongTensor] = None, | |
| upp_labels: Optional[torch.LongTensor] = None, | |
| use_cache: Optional[bool] = None, | |
| output_attentions: Optional[bool] = None, | |
| output_hidden_states: Optional[bool] = None, | |
| return_dict: Optional[bool] = None, | |
| cache_position: Optional[torch.LongTensor] = None, | |
| forced_decoder_ids: Optional[torch.LongTensor] = None, | |
| enrollments= None, | |
| ) -> Union[tuple[torch.Tensor], Seq2SeqLMOutput]: | |
| r""" | |
| labels (`torch.LongTensor` of shape `(batch_size, sequence_length)`, *optional*): | |
| Labels for computing the language modeling loss. Indices should either be in `[0, ..., config.vocab_size]` | |
| or -100 (see `input_ids` docstring). Tokens with indices set to `-100` are ignored (masked), the loss is | |
| only computed for the tokens with labels in `[0, ..., config.vocab_size]`. | |
| Returns: | |
| """ | |
| return_dict = return_dict if return_dict is not None else self.config.use_return_dict | |
| if labels is not None: | |
| if decoder_input_ids is None and decoder_inputs_embeds is None: | |
| decoder_input_ids = shift_tokens_right( | |
| labels, self.config.pad_token_id, self.config.decoder_start_token_id | |
| ) | |
| outputs = self.model( | |
| input_features, | |
| attention_mask=attention_mask, | |
| decoder_input_ids=decoder_input_ids, | |
| encoder_outputs=encoder_outputs, | |
| decoder_attention_mask=decoder_attention_mask, | |
| head_mask=head_mask, | |
| decoder_head_mask=decoder_head_mask, | |
| cross_attn_head_mask=cross_attn_head_mask, | |
| past_key_values=past_key_values, | |
| decoder_inputs_embeds=decoder_inputs_embeds, | |
| decoder_position_ids=decoder_position_ids, | |
| use_cache=use_cache, | |
| output_attentions=output_attentions, | |
| output_hidden_states=output_hidden_states, | |
| return_dict=return_dict, | |
| cache_position=cache_position, | |
| stno_mask=stno_mask, | |
| enrollments=enrollments, | |
| ) | |
| dec_lm_logits = self.proj_out(outputs.last_hidden_state) | |
| loss = None | |
| if labels is not None: | |
| loss_fct = CrossEntropyLoss(reduction='none') | |
| # move labels to correct device to enable PP | |
| labels = labels.to(dec_lm_logits.device) | |
| dec_loss1 = loss_fct(dec_lm_logits.view(-1, self.config.vocab_size), labels.reshape(-1)) | |
| dec_loss2 = loss_fct(dec_lm_logits.view(-1, self.config.vocab_size), upp_labels.reshape(-1)) | |
| dec_loss = torch.hstack((dec_loss1[..., None], dec_loss2[..., None])).min(dim=-1).values.mean() | |
| if self.config.ctc_weight > 0.0: | |
| enc_lm_logits = self.get_enc_logits(outputs.encoder_last_hidden_state) | |
| enc_labels = labels.clone() | |
| for token in self.tokenizer.prefix_tokens: | |
| if (enc_labels[:, 0] == token).all(): | |
| enc_labels = enc_labels[:, 1:] | |
| enc_labels[enc_labels == self.config.eos_token_id] = -100 | |
| ctc_loss = self.get_encoder().get_loss(enc_lm_logits, enc_labels) | |
| loss = (1 - self.config.ctc_weight) * dec_loss + self.config.ctc_weight * ctc_loss | |
| else: | |
| loss = dec_loss | |
| if not return_dict: | |
| output = (dec_lm_logits,) + outputs[1:] | |
| return ((loss,) + output) if loss is not None else output | |
| return Seq2SeqLMOutput( | |
| loss=loss, | |
| logits=dec_lm_logits, | |
| past_key_values=outputs.past_key_values, | |
| decoder_hidden_states=outputs.decoder_hidden_states, | |
| decoder_attentions=outputs.decoder_attentions, | |
| cross_attentions=outputs.cross_attentions, | |
| encoder_last_hidden_state=outputs.encoder_last_hidden_state, | |
| encoder_hidden_states=outputs.encoder_hidden_states, | |
| encoder_attentions=outputs.encoder_attentions, | |
| ) | |
| def _get_feat_extract_output_lengths(self, attention_mask: torch.LongTensor) -> torch.LongTensor: | |
| return (self.model.get_encoder()._get_feat_extract_output_lengths(attention_mask) / 4).ceil() | |