Text-to-Speech
Transformers
ONNX
Safetensors
English
Chinese
bailing_moe_v3_audio
feature-extraction
audio
speech
automatic-speech-recognition
audio-understanding
audio-reasoning
speech-to-text
conversational
mixture-of-experts
custom_code
Instructions to use eshmoideas/Ming-audio with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use eshmoideas/Ming-audio with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-to-speech", model="eshmoideas/Ming-audio", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("eshmoideas/Ming-audio", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
Download talker/talker_module/modules.py from eshmoideas/Ming-audio: direct link, hf CLI and curl.
- Browser
- Download file 11.3 kB
-
https://huggingface.co/eshmoideas/Ming-audio/resolve/main/talker/talker_module/modules.py
- Command line
-
hf download hf://eshmoideas/Ming-audio/talker/talker_module/modules.py
-
curl -L -o modules.py https://huggingface.co/eshmoideas/Ming-audio/resolve/main/talker/talker_module/modules.py
11.3 kB
| from typing import Optional | |
| import torch | |
| import torch.nn.functional as F | |
| from torch import nn | |
| from x_transformers.x_transformers import apply_rotary_pos_emb | |
| def is_package_available(package_name: str) -> bool: | |
| try: | |
| import importlib | |
| package_exists = importlib.util.find_spec(package_name) is not None | |
| return package_exists | |
| except Exception: | |
| return False | |
| if is_package_available("flash_attn"): | |
| from flash_attn.bert_padding import pad_input, unpad_input | |
| from flash_attn import flash_attn_varlen_func, flash_attn_func | |
| class RMSNorm(nn.Module): | |
| def __init__(self, dim: int, eps: float): | |
| super().__init__() | |
| self.eps = eps | |
| self.weight = nn.Parameter(torch.ones(dim)) | |
| self.native_rms_norm = float(torch.__version__[:3]) >= 2.4 | |
| def forward(self, x): | |
| if self.native_rms_norm: | |
| if self.weight.dtype in [torch.float16, torch.bfloat16]: | |
| x = x.to(self.weight.dtype) | |
| x = F.rms_norm(x, normalized_shape=(x.shape[-1],), weight=self.weight, eps=self.eps) | |
| else: | |
| variance = x.to(torch.float32).pow(2).mean(-1, keepdim=True) | |
| x = x * torch.rsqrt(variance + self.eps) | |
| if self.weight.dtype in [torch.float16, torch.bfloat16]: | |
| x = x.to(self.weight.dtype) | |
| x = x * self.weight | |
| return x | |
| class FeedForward(nn.Module): | |
| def __init__(self, dim, dim_out=None, mult=4, dropout=0.0, approximate: str = "none"): | |
| super().__init__() | |
| inner_dim = int(dim * mult) | |
| dim_out = dim_out if dim_out is not None else dim | |
| activation = nn.GELU(approximate=approximate) | |
| project_in = nn.Sequential(nn.Linear(dim, inner_dim), activation) | |
| self.ff = nn.Sequential(project_in, nn.Dropout(dropout), nn.Linear(inner_dim, dim_out)) | |
| def forward(self, x): | |
| return self.ff(x) | |
| class Attention(nn.Module): | |
| def __init__( | |
| self, | |
| dim: int, | |
| heads: int = 8, | |
| dim_head: int = 64, | |
| dropout: float = 0.0, | |
| qk_norm: Optional[str] = None, | |
| pe_attn_head: int | None = None, # number of attention head to apply rope, None for all | |
| attn_backend: str = "torch", # "torch" or "flash_attn" | |
| attn_mask_enabled: bool = True, | |
| ): | |
| super().__init__() | |
| if not hasattr(F, "scaled_dot_product_attention"): | |
| raise ImportError("Attention equires PyTorch 2.0, to use it, please upgrade PyTorch to 2.0.") | |
| self.dim = dim | |
| self.heads = heads | |
| self.inner_dim = dim_head * heads | |
| self.dropout = dropout | |
| self.to_q = nn.Linear(dim, self.inner_dim) | |
| self.to_k = nn.Linear(dim, self.inner_dim) | |
| self.to_v = nn.Linear(dim, self.inner_dim) | |
| if qk_norm is None: | |
| self.q_norm = None | |
| self.k_norm = None | |
| elif qk_norm == "rms_norm": | |
| self.q_norm = RMSNorm(dim_head, eps=1e-6) | |
| self.k_norm = RMSNorm(dim_head, eps=1e-6) | |
| else: | |
| raise ValueError(f"Unimplemented qk_norm: {qk_norm}") | |
| self.to_out = nn.ModuleList([]) | |
| self.to_out.append(nn.Linear(self.inner_dim, dim)) | |
| self.to_out.append(nn.Dropout(dropout)) | |
| if attn_backend == "flash_attn": | |
| assert is_package_available("flash_attn"), "Please install flash-attn first." | |
| self.pe_attn_head = pe_attn_head | |
| self.attn_backend = attn_backend | |
| self.attn_mask_enabled = attn_mask_enabled | |
| def forward( | |
| self, | |
| x: float, # noised input x | |
| mask=None, | |
| rope=None, # rotary position embedding for x | |
| ) -> torch.Tensor: | |
| batch_size = x.shape[0] | |
| # `sample` projections | |
| query = self.to_q(x) | |
| key = self.to_k(x) | |
| value = self.to_v(x) | |
| # attention | |
| inner_dim = key.shape[-1] | |
| head_dim = inner_dim // self.heads | |
| query = query.view(batch_size, -1, self.heads, head_dim).transpose(1, 2) | |
| key = key.view(batch_size, -1, self.heads, head_dim).transpose(1, 2) | |
| value = value.view(batch_size, -1, self.heads, head_dim).transpose(1, 2) | |
| # qk norm | |
| if self.q_norm is not None: | |
| query = self.q_norm(query) | |
| if self.k_norm is not None: | |
| key = self.k_norm(key) | |
| # apply rotary position embedding | |
| if rope is not None: | |
| freqs, xpos_scale = rope | |
| q_xpos_scale, k_xpos_scale = (xpos_scale, xpos_scale ** -1.0) if xpos_scale is not None else (1.0, 1.0) | |
| if self.pe_attn_head is not None: | |
| pn = self.pe_attn_head | |
| query[:, :pn, :, :] = apply_rotary_pos_emb(query[:, :pn, :, :], freqs, q_xpos_scale) | |
| key[:, :pn, :, :] = apply_rotary_pos_emb(key[:, :pn, :, :], freqs, k_xpos_scale) | |
| else: | |
| query = apply_rotary_pos_emb(query, freqs, q_xpos_scale) | |
| key = apply_rotary_pos_emb(key, freqs, k_xpos_scale) | |
| if self.attn_backend == "torch": | |
| # mask. e.g. inference got a batch with different target durations, mask out the padding | |
| if self.attn_mask_enabled and mask is not None: | |
| valid_sample_indices = mask.any(dim=1) | |
| final_output = torch.zeros_like(query).to(query.device) | |
| attn_mask = mask[valid_sample_indices] | |
| query = query[valid_sample_indices] | |
| key = key[valid_sample_indices] | |
| value = value[valid_sample_indices] | |
| attn_mask = attn_mask.unsqueeze(1).unsqueeze(1) # 'b n -> b 1 1 n' | |
| attn_mask = attn_mask.expand(valid_sample_indices.sum().item(), self.heads, query.shape[-2], | |
| key.shape[-2]) | |
| else: | |
| attn_mask = None | |
| x = F.scaled_dot_product_attention(query, key, value, attn_mask=attn_mask, dropout_p=0.0, is_causal=False) | |
| if self.attn_mask_enabled and mask is not None: | |
| final_output[valid_sample_indices] = x | |
| x = final_output | |
| x = x.transpose(1, 2).reshape(batch_size, -1, self.heads * head_dim) | |
| elif self.attn_backend == "flash_attn": | |
| query = query.transpose(1, 2) # [b, h, n, d] -> [b, n, h, d] | |
| key = key.transpose(1, 2) | |
| value = value.transpose(1, 2) | |
| if self.attn_mask_enabled and mask is not None: | |
| query, indices, q_cu_seqlens, q_max_seqlen_in_batch = unpad_input(query, mask) | |
| key, _, k_cu_seqlens, k_max_seqlen_in_batch = unpad_input(key, mask) | |
| value, _, _, _ = unpad_input(value, mask) | |
| x = flash_attn_varlen_func( | |
| query, | |
| key, | |
| value, | |
| q_cu_seqlens, | |
| k_cu_seqlens, | |
| q_max_seqlen_in_batch, | |
| k_max_seqlen_in_batch, | |
| ) | |
| x = pad_input(x, indices, batch_size, q_max_seqlen_in_batch) | |
| x = x.reshape(batch_size, -1, self.heads * head_dim) | |
| else: | |
| x = flash_attn_func(query, key, value, dropout_p=0.0, causal=False) | |
| x = x.reshape(batch_size, -1, self.heads * head_dim) | |
| x = x.to(query.dtype) | |
| # linear proj | |
| x = self.to_out[0](x) | |
| # dropout | |
| x = self.to_out[1](x) | |
| if mask is not None: | |
| mask = mask.unsqueeze(-1) | |
| x = x.masked_fill(~mask, 0.0) | |
| return x | |
| class DiTBlock(nn.Module): | |
| """ | |
| A DiT block with adaptive layer norm zero (adaLN-Zero) conditioning. | |
| """ | |
| def __init__( | |
| self, | |
| hidden_size, | |
| num_heads, | |
| mlp_ratio=4.0, | |
| dropout=0.1, | |
| qk_norm=None, | |
| pe_attn_head=None, | |
| attn_backend="flash_attn", # "torch" or "flash_attn" | |
| attn_mask_enabled=True, | |
| **kwargs | |
| ): | |
| super().__init__() | |
| self.norm1 = RMSNorm(hidden_size, eps=1e-6) | |
| self.attn = Attention( | |
| dim=hidden_size, | |
| heads=num_heads, | |
| dim_head=hidden_size // num_heads, | |
| dropout=dropout, | |
| qk_norm=qk_norm, | |
| pe_attn_head=pe_attn_head, | |
| attn_backend=attn_backend, | |
| attn_mask_enabled=attn_mask_enabled, | |
| ) | |
| self.norm2 = RMSNorm(hidden_size, eps=1e-6) | |
| self.mlp = FeedForward(dim=hidden_size, mult=mlp_ratio, dropout=dropout, approximate="tanh") | |
| def forward(self, x, mask, rope): | |
| x = x + self.attn(self.norm1(x), mask=mask, rope=rope) | |
| x = x + self.mlp(self.norm2(x)) | |
| return x | |
| class FinalLayer(nn.Module): | |
| """ | |
| The final layer of DiT. | |
| """ | |
| def __init__(self, hidden_size, out_channels): | |
| super().__init__() | |
| self.norm_final = RMSNorm(hidden_size, eps=1e-6) | |
| self.linear = nn.Linear(hidden_size, out_channels, bias=True) | |
| def forward(self, x): | |
| x = self.norm_final(x) | |
| x = self.linear(x) | |
| return x | |
| def modulate(x, shift, scale): | |
| return x * (1 + scale) + shift | |
| class FinalLayer_mlp(nn.Module): | |
| """ | |
| The final layer adopted from DiT. | |
| """ | |
| def __init__(self, model_channels, out_channels, cond_fuse_method="add"): | |
| super().__init__() | |
| self.norm_final = nn.LayerNorm(model_channels, elementwise_affine=False, eps=1e-6) | |
| self.linear = nn.Linear(model_channels, out_channels, bias=True) | |
| if cond_fuse_method == "add": | |
| self.adaLN_modulation = nn.Sequential( | |
| nn.SiLU(), | |
| nn.Linear(model_channels, 2 * model_channels, bias=True) | |
| ) | |
| else: | |
| self.adaLN_modulation = nn.Sequential( | |
| nn.SiLU(), | |
| nn.Linear(2 * model_channels, 2 * model_channels, bias=True) | |
| ) | |
| def forward(self, x, c): | |
| shift, scale = self.adaLN_modulation(c).chunk(2, dim=-1) | |
| x = modulate(self.norm_final(x), shift, scale) | |
| x = self.linear(x) | |
| return x | |
| class ResBlock(nn.Module): | |
| """ | |
| A residual block that can optionally change the number of channels. | |
| :param channels: the number of input channels. | |
| """ | |
| def __init__( | |
| self, | |
| channels, | |
| cond_fuse_method="add" | |
| ): | |
| super().__init__() | |
| self.channels = channels | |
| self.in_ln = nn.LayerNorm(channels, eps=1e-6) | |
| self.mlp = nn.Sequential( | |
| nn.Linear(channels, channels, bias=True), | |
| nn.SiLU(), | |
| nn.Linear(channels, channels, bias=True), | |
| ) | |
| if cond_fuse_method == "add": | |
| self.adaLN_modulation = nn.Sequential( | |
| nn.SiLU(), | |
| nn.Linear(channels, 3 * channels, bias=True) | |
| ) | |
| else: | |
| self.adaLN_modulation = nn.Sequential( | |
| nn.SiLU(), | |
| nn.Linear(2 * channels, 3 * channels, bias=True) | |
| ) | |
| def forward(self, x, y): | |
| shift_mlp, scale_mlp, gate_mlp = self.adaLN_modulation(y).chunk(3, dim=-1) | |
| h = modulate(self.in_ln(x), shift_mlp, scale_mlp) | |
| h = self.mlp(h) | |
| return x + gate_mlp * h | |