modeling_t5gemma.py 59 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385
  1. # 🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
  2. # This file was automatically generated from src/transformers/models/t5gemma/modular_t5gemma.py.
  3. # Do NOT edit this file manually as any edits will be overwritten by the generation of
  4. # the file from the modular. If any change should be done, please apply the change to the
  5. # modular_t5gemma.py file directly. One of our CI enforces this.
  6. # 🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
  7. # coding=utf-8
  8. # Copyright 2025 Google Inc. HuggingFace Inc. team. All rights reserved.
  9. #
  10. #
  11. # Licensed under the Apache License, Version 2.0 (the "License");
  12. # you may not use this file except in compliance with the License.
  13. # You may obtain a copy of the License at
  14. #
  15. # http://www.apache.org/licenses/LICENSE-2.0
  16. #
  17. # Unless required by applicable law or agreed to in writing, software
  18. # distributed under the License is distributed on an "AS IS" BASIS,
  19. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  20. # See the License for the specific language governing permissions and
  21. # limitations under the License.
  22. from typing import Callable, Optional, Union
  23. import torch
  24. import torch.nn as nn
  25. from ...activations import ACT2FN
  26. from ...cache_utils import Cache, DynamicCache, EncoderDecoderCache
  27. from ...generation import GenerationMixin
  28. from ...masking_utils import create_causal_mask, create_sliding_window_causal_mask
  29. from ...modeling_flash_attention_utils import FlashAttentionKwargs
  30. from ...modeling_layers import GradientCheckpointingLayer
  31. from ...modeling_outputs import (
  32. BaseModelOutput,
  33. BaseModelOutputWithPastAndCrossAttentions,
  34. Seq2SeqLMOutput,
  35. Seq2SeqModelOutput,
  36. SequenceClassifierOutput,
  37. TokenClassifierOutput,
  38. )
  39. from ...modeling_rope_utils import ROPE_INIT_FUNCTIONS, dynamic_rope_update
  40. from ...modeling_utils import ALL_ATTENTION_FUNCTIONS, PreTrainedModel
  41. from ...processing_utils import Unpack
  42. from ...utils import TransformersKwargs, auto_docstring, can_return_tuple, logging
  43. from ...utils.deprecation import deprecate_kwarg
  44. from ...utils.generic import OutputRecorder, check_model_inputs
  45. from .configuration_t5gemma import T5GemmaConfig, T5GemmaModuleConfig
  46. logger = logging.get_logger(__name__)
  47. class T5GemmaRMSNorm(nn.Module):
  48. def __init__(self, dim: int, eps: float = 1e-6):
  49. super().__init__()
  50. self.eps = eps
  51. self.weight = nn.Parameter(torch.zeros(dim))
  52. def _norm(self, x):
  53. return x * torch.rsqrt(x.pow(2).mean(-1, keepdim=True) + self.eps)
  54. def forward(self, x):
  55. output = self._norm(x.float())
  56. # Llama does x.to(float16) * w whilst T5Gemma is (x * w).to(float16)
  57. # See https://github.com/huggingface/transformers/pull/29402
  58. output = output * (1.0 + self.weight.float())
  59. return output.type_as(x)
  60. def extra_repr(self):
  61. return f"{tuple(self.weight.shape)}, eps={self.eps}"
  62. class T5GemmaMLP(nn.Module):
  63. def __init__(self, config):
  64. super().__init__()
  65. self.config = config
  66. self.hidden_size = config.hidden_size
  67. self.intermediate_size = config.intermediate_size
  68. self.gate_proj = nn.Linear(self.hidden_size, self.intermediate_size, bias=False)
  69. self.up_proj = nn.Linear(self.hidden_size, self.intermediate_size, bias=False)
  70. self.down_proj = nn.Linear(self.intermediate_size, self.hidden_size, bias=False)
  71. self.act_fn = ACT2FN[config.hidden_activation]
  72. self.dropout = nn.Dropout(config.dropout_rate)
  73. def forward(self, x):
  74. hidden_states = self.act_fn(self.gate_proj(x)) * self.up_proj(x)
  75. hidden_states = self.dropout(hidden_states)
  76. down_proj = self.down_proj(hidden_states)
  77. return down_proj
  78. class T5GemmaRotaryEmbedding(nn.Module):
  79. inv_freq: torch.Tensor # fix linting for `register_buffer`
  80. def __init__(self, config, device=None):
  81. super().__init__()
  82. # BC: "rope_type" was originally "type"
  83. if hasattr(config, "rope_scaling") and isinstance(config.rope_scaling, dict):
  84. self.rope_type = config.rope_scaling.get("rope_type", config.rope_scaling.get("type"))
  85. else:
  86. self.rope_type = "default"
  87. self.max_seq_len_cached = config.max_position_embeddings
  88. self.original_max_seq_len = config.max_position_embeddings
  89. self.config = config
  90. self.rope_init_fn = ROPE_INIT_FUNCTIONS[self.rope_type]
  91. inv_freq, self.attention_scaling = self.rope_init_fn(self.config, device)
  92. self.register_buffer("inv_freq", inv_freq, persistent=False)
  93. self.original_inv_freq = self.inv_freq
  94. @torch.no_grad()
  95. @dynamic_rope_update # power user: used with advanced RoPE types (e.g. dynamic rope)
  96. def forward(self, x, position_ids):
  97. inv_freq_expanded = self.inv_freq[None, :, None].float().expand(position_ids.shape[0], -1, 1).to(x.device)
  98. position_ids_expanded = position_ids[:, None, :].float()
  99. device_type = x.device.type if isinstance(x.device.type, str) and x.device.type != "mps" else "cpu"
  100. with torch.autocast(device_type=device_type, enabled=False): # Force float32
  101. freqs = (inv_freq_expanded.float() @ position_ids_expanded.float()).transpose(1, 2)
  102. emb = torch.cat((freqs, freqs), dim=-1)
  103. cos = emb.cos() * self.attention_scaling
  104. sin = emb.sin() * self.attention_scaling
  105. return cos.to(dtype=x.dtype), sin.to(dtype=x.dtype)
  106. def rotate_half(x):
  107. """Rotates half the hidden dims of the input."""
  108. x1 = x[..., : x.shape[-1] // 2]
  109. x2 = x[..., x.shape[-1] // 2 :]
  110. return torch.cat((-x2, x1), dim=-1)
  111. def apply_rotary_pos_emb(q, k, cos, sin, position_ids=None, unsqueeze_dim=1):
  112. """Applies Rotary Position Embedding to the query and key tensors.
  113. Args:
  114. q (`torch.Tensor`): The query tensor.
  115. k (`torch.Tensor`): The key tensor.
  116. cos (`torch.Tensor`): The cosine part of the rotary embedding.
  117. sin (`torch.Tensor`): The sine part of the rotary embedding.
  118. position_ids (`torch.Tensor`, *optional*):
  119. Deprecated and unused.
  120. unsqueeze_dim (`int`, *optional*, defaults to 1):
  121. The 'unsqueeze_dim' argument specifies the dimension along which to unsqueeze cos[position_ids] and
  122. sin[position_ids] so that they can be properly broadcasted to the dimensions of q and k. For example, note
  123. that cos[position_ids] and sin[position_ids] have the shape [batch_size, seq_len, head_dim]. Then, if q and
  124. k have the shape [batch_size, heads, seq_len, head_dim], then setting unsqueeze_dim=1 makes
  125. cos[position_ids] and sin[position_ids] broadcastable to the shapes of q and k. Similarly, if q and k have
  126. the shape [batch_size, seq_len, heads, head_dim], then set unsqueeze_dim=2.
  127. Returns:
  128. `tuple(torch.Tensor)` comprising of the query and key tensors rotated using the Rotary Position Embedding.
  129. """
  130. cos = cos.unsqueeze(unsqueeze_dim)
  131. sin = sin.unsqueeze(unsqueeze_dim)
  132. q_embed = (q * cos) + (rotate_half(q) * sin)
  133. k_embed = (k * cos) + (rotate_half(k) * sin)
  134. return q_embed, k_embed
  135. def repeat_kv(hidden_states: torch.Tensor, n_rep: int) -> torch.Tensor:
  136. """
  137. This is the equivalent of torch.repeat_interleave(x, dim=1, repeats=n_rep). The hidden states go from (batch,
  138. num_key_value_heads, seqlen, head_dim) to (batch, num_attention_heads, seqlen, head_dim)
  139. """
  140. batch, num_key_value_heads, slen, head_dim = hidden_states.shape
  141. if n_rep == 1:
  142. return hidden_states
  143. hidden_states = hidden_states[:, :, None, :, :].expand(batch, num_key_value_heads, n_rep, slen, head_dim)
  144. return hidden_states.reshape(batch, num_key_value_heads * n_rep, slen, head_dim)
  145. def eager_attention_forward(
  146. module: nn.Module,
  147. query: torch.Tensor,
  148. key: torch.Tensor,
  149. value: torch.Tensor,
  150. attention_mask: Optional[torch.Tensor],
  151. dropout: float = 0.0,
  152. scaling: Optional[float] = None,
  153. softcap: Optional[float] = None,
  154. **kwargs,
  155. ) -> tuple[torch.Tensor, torch.Tensor]:
  156. if scaling is None:
  157. scaling = module.head_dim**-0.5
  158. key_states = repeat_kv(key, module.num_key_value_groups)
  159. value_states = repeat_kv(value, module.num_key_value_groups)
  160. attn_weights = torch.matmul(query, key_states.transpose(2, 3)) * scaling
  161. if softcap is not None:
  162. attn_weights = attn_weights / softcap
  163. attn_weights = torch.tanh(attn_weights)
  164. attn_weights = attn_weights * softcap
  165. if attention_mask is not None: # no matter the length, we just slice it
  166. causal_mask = attention_mask[:, :, :, : key_states.shape[-2]]
  167. attn_weights = attn_weights + causal_mask
  168. # upcast attention to fp32
  169. attn_weights = nn.functional.softmax(attn_weights, dim=-1, dtype=torch.float32).to(query.dtype)
  170. attn_weights = nn.functional.dropout(attn_weights, p=dropout, training=module.training)
  171. attn_output = torch.matmul(attn_weights, value_states)
  172. attn_output = attn_output.transpose(1, 2).contiguous()
  173. return attn_output, attn_weights
  174. class T5GemmaSelfAttention(nn.Module):
  175. """Multi-headed attention from 'Attention Is All You Need' paper"""
  176. def __init__(self, config: T5GemmaModuleConfig, layer_idx: int):
  177. super().__init__()
  178. self.config = config
  179. self.layer_idx = layer_idx
  180. self.head_dim = getattr(config, "head_dim", config.hidden_size // config.num_attention_heads)
  181. self.num_key_value_groups = config.num_attention_heads // config.num_key_value_heads
  182. self.scaling = config.query_pre_attn_scalar**-0.5
  183. self.attention_dropout = self.config.attention_dropout
  184. # Required by flash attention: encoder selfattention is non-causal
  185. self.is_causal = config.is_decoder
  186. self.q_proj = nn.Linear(
  187. config.hidden_size, config.num_attention_heads * self.head_dim, bias=config.attention_bias
  188. )
  189. self.k_proj = nn.Linear(
  190. config.hidden_size, config.num_key_value_heads * self.head_dim, bias=config.attention_bias
  191. )
  192. self.v_proj = nn.Linear(
  193. config.hidden_size, config.num_key_value_heads * self.head_dim, bias=config.attention_bias
  194. )
  195. self.o_proj = nn.Linear(
  196. config.num_attention_heads * self.head_dim, config.hidden_size, bias=config.attention_bias
  197. )
  198. self.attn_logit_softcapping = self.config.attn_logit_softcapping
  199. self.sliding_window = config.sliding_window if config.layer_types[layer_idx] == "sliding_attention" else None
  200. @deprecate_kwarg("past_key_value", new_name="past_key_values", version="4.58")
  201. def forward(
  202. self,
  203. hidden_states: torch.Tensor,
  204. position_embeddings: tuple[torch.Tensor, torch.Tensor],
  205. attention_mask: Optional[torch.Tensor],
  206. past_key_values: Optional[Cache] = None,
  207. cache_position: Optional[torch.LongTensor] = None,
  208. **kwargs: Unpack[FlashAttentionKwargs],
  209. ) -> tuple[torch.Tensor, Optional[torch.Tensor], Optional[tuple[torch.Tensor]]]:
  210. input_shape = hidden_states.shape[:-1]
  211. hidden_shape = (*input_shape, -1, self.head_dim)
  212. query_states = self.q_proj(hidden_states).view(hidden_shape).transpose(1, 2)
  213. key_states = self.k_proj(hidden_states).view(hidden_shape).transpose(1, 2)
  214. value_states = self.v_proj(hidden_states).view(hidden_shape).transpose(1, 2)
  215. cos, sin = position_embeddings
  216. query_states, key_states = apply_rotary_pos_emb(query_states, key_states, cos, sin)
  217. if past_key_values is not None:
  218. # sin and cos are specific to RoPE models; cache_position needed for the static cache
  219. cache_kwargs = {"sin": sin, "cos": cos, "cache_position": cache_position}
  220. key_states, value_states = past_key_values.update(key_states, value_states, self.layer_idx, cache_kwargs)
  221. attention_interface: Callable = eager_attention_forward
  222. if self.config._attn_implementation != "eager":
  223. attention_interface = ALL_ATTENTION_FUNCTIONS[self.config._attn_implementation]
  224. attn_output, attn_weights = attention_interface(
  225. self,
  226. query_states,
  227. key_states,
  228. value_states,
  229. attention_mask,
  230. dropout=self.attention_dropout if self.training else 0.0,
  231. scaling=self.scaling,
  232. sliding_window=self.sliding_window,
  233. softcap=self.attn_logit_softcapping,
  234. **kwargs,
  235. )
  236. attn_output = attn_output.reshape(*input_shape, -1).contiguous()
  237. attn_output = self.o_proj(attn_output)
  238. return attn_output, attn_weights
  239. class T5GemmaCrossAttention(nn.Module):
  240. """Multi-headed attention from 'Attention Is All You Need' paper"""
  241. def __init__(self, config: T5GemmaModuleConfig, layer_idx: int):
  242. super().__init__()
  243. self.config = config
  244. self.layer_idx = layer_idx
  245. self.head_dim = getattr(config, "head_dim", config.hidden_size // config.num_attention_heads)
  246. self.num_key_value_groups = config.num_attention_heads // config.num_key_value_heads
  247. self.scaling = config.query_pre_attn_scalar**-0.5
  248. self.attention_dropout = self.config.attention_dropout
  249. self.is_causal = False
  250. self.q_proj = nn.Linear(
  251. config.hidden_size, config.num_attention_heads * self.head_dim, bias=config.attention_bias
  252. )
  253. self.k_proj = nn.Linear(
  254. config.cross_attention_hidden_size, config.num_key_value_heads * self.head_dim, bias=config.attention_bias
  255. )
  256. self.v_proj = nn.Linear(
  257. config.cross_attention_hidden_size, config.num_key_value_heads * self.head_dim, bias=config.attention_bias
  258. )
  259. self.o_proj = nn.Linear(
  260. config.num_attention_heads * self.head_dim, config.hidden_size, bias=config.attention_bias
  261. )
  262. self.attn_logit_softcapping = self.config.attn_logit_softcapping
  263. if config.cross_attention_hidden_size is None:
  264. raise ValueError("Cross-attention needs cross_attention_hidden_size to be specified.")
  265. @deprecate_kwarg("past_key_value", new_name="past_key_values", version="4.58")
  266. def forward(
  267. self,
  268. hidden_states: torch.Tensor,
  269. attention_mask: Optional[torch.Tensor],
  270. encoder_hidden_states: Optional[torch.Tensor],
  271. past_key_values: Optional[Cache] = None,
  272. **kwargs: Unpack[FlashAttentionKwargs],
  273. ) -> tuple[torch.Tensor, Optional[torch.Tensor], Optional[tuple[torch.Tensor]]]:
  274. if encoder_hidden_states is None:
  275. raise ValueError("Encoder hidden state is required for cross attention.")
  276. input_shape = hidden_states.shape[:-1]
  277. hidden_shape = (*input_shape, -1, self.head_dim)
  278. query_states = self.q_proj(hidden_states).view(hidden_shape).transpose(1, 2)
  279. if past_key_values is not None:
  280. is_updated = past_key_values.is_updated.get(self.layer_idx)
  281. curr_past_key_value = past_key_values.cross_attention_cache
  282. if past_key_values is None or not is_updated:
  283. encoder_input_shape = encoder_hidden_states.shape[:-1]
  284. encoder_hidden_shape = (*encoder_input_shape, -1, self.head_dim)
  285. key_states = self.k_proj(encoder_hidden_states).view(encoder_hidden_shape).transpose(1, 2)
  286. value_states = self.v_proj(encoder_hidden_states).view(encoder_hidden_shape).transpose(1, 2)
  287. if past_key_values is not None:
  288. key_states, value_states = curr_past_key_value.update(key_states, value_states, self.layer_idx)
  289. past_key_values.is_updated[self.layer_idx] = True
  290. else:
  291. key_states = curr_past_key_value.layers[self.layer_idx].keys
  292. value_states = curr_past_key_value.layers[self.layer_idx].values
  293. attention_interface: Callable = eager_attention_forward
  294. if self.config._attn_implementation != "eager":
  295. attention_interface = ALL_ATTENTION_FUNCTIONS[self.config._attn_implementation]
  296. attn_output, attn_weights = attention_interface(
  297. self,
  298. query_states,
  299. key_states,
  300. value_states,
  301. attention_mask,
  302. dropout=self.attention_dropout if self.training else 0.0,
  303. scaling=self.scaling,
  304. sliding_window=None,
  305. softcap=self.attn_logit_softcapping,
  306. **kwargs,
  307. )
  308. attn_output = attn_output.reshape(*input_shape, -1).contiguous()
  309. attn_output = self.o_proj(attn_output)
  310. return attn_output, attn_weights
  311. class T5GemmaEncoderLayer(GradientCheckpointingLayer):
  312. """Encoder sub-layer."""
  313. def __init__(self, config, layer_idx: int):
  314. super().__init__()
  315. self.hidden_size = config.hidden_size
  316. self.config = config
  317. self.layer_idx = layer_idx
  318. self.attention_type = config.layer_types[layer_idx]
  319. self.self_attn = T5GemmaSelfAttention(
  320. config=config,
  321. layer_idx=layer_idx,
  322. )
  323. self.pre_self_attn_layernorm = T5GemmaRMSNorm(config.hidden_size, eps=config.rms_norm_eps)
  324. self.post_self_attn_layernorm = T5GemmaRMSNorm(config.hidden_size, eps=config.rms_norm_eps)
  325. self.mlp = T5GemmaMLP(config)
  326. self.pre_feedforward_layernorm = T5GemmaRMSNorm(config.hidden_size, eps=config.rms_norm_eps)
  327. self.post_feedforward_layernorm = T5GemmaRMSNorm(config.hidden_size, eps=config.rms_norm_eps)
  328. self.dropout = nn.Dropout(config.dropout_rate)
  329. def forward(
  330. self,
  331. hidden_states: torch.Tensor,
  332. position_embeddings: tuple[torch.Tensor, torch.Tensor],
  333. attention_mask: Optional[torch.Tensor] = None,
  334. position_ids: Optional[torch.LongTensor] = None,
  335. **kwargs,
  336. ) -> tuple[torch.FloatTensor,]:
  337. residual = hidden_states
  338. hidden_states = self.pre_self_attn_layernorm(hidden_states)
  339. hidden_states, _ = self.self_attn(
  340. hidden_states=hidden_states,
  341. position_embeddings=position_embeddings,
  342. attention_mask=attention_mask,
  343. position_ids=position_ids,
  344. past_key_values=None,
  345. **kwargs,
  346. )
  347. hidden_states = self.post_self_attn_layernorm(hidden_states)
  348. hidden_states = residual + self.dropout(hidden_states)
  349. residual = hidden_states
  350. hidden_states = self.pre_feedforward_layernorm(hidden_states)
  351. hidden_states = self.mlp(hidden_states)
  352. hidden_states = self.post_feedforward_layernorm(hidden_states)
  353. hidden_states = residual + self.dropout(hidden_states)
  354. return hidden_states
  355. class T5GemmaDecoderLayer(T5GemmaEncoderLayer):
  356. """Decoder sub-layer: an extra cross-attention layer."""
  357. def __init__(self, config, layer_idx: int):
  358. super().__init__(config, layer_idx)
  359. self.cross_attn = T5GemmaCrossAttention(config=config, layer_idx=layer_idx)
  360. self.pre_cross_attn_layernorm = T5GemmaRMSNorm(config.hidden_size, eps=config.rms_norm_eps)
  361. self.post_cross_attn_layernorm = T5GemmaRMSNorm(config.hidden_size, eps=config.rms_norm_eps)
  362. @deprecate_kwarg("past_key_value", new_name="past_key_values", version="4.58")
  363. def forward(
  364. self,
  365. hidden_states: torch.Tensor,
  366. position_embeddings: tuple[torch.Tensor, torch.Tensor],
  367. attention_mask: Optional[torch.Tensor] = None,
  368. position_ids: Optional[torch.LongTensor] = None,
  369. past_key_values: Optional[EncoderDecoderCache] = None,
  370. use_cache: Optional[bool] = False,
  371. cache_position: Optional[torch.LongTensor] = None,
  372. encoder_hidden_states: Optional[torch.Tensor] = None,
  373. encoder_attention_mask: Optional[torch.Tensor] = None,
  374. **kwargs,
  375. ) -> torch.FloatTensor:
  376. residual = hidden_states
  377. hidden_states = self.pre_self_attn_layernorm(hidden_states)
  378. hidden_states, _ = self.self_attn(
  379. hidden_states=hidden_states,
  380. position_embeddings=position_embeddings,
  381. attention_mask=attention_mask,
  382. position_ids=position_ids,
  383. past_key_values=past_key_values.self_attention_cache if past_key_values is not None else None,
  384. use_cache=use_cache,
  385. cache_position=cache_position,
  386. **kwargs,
  387. )
  388. hidden_states = self.post_self_attn_layernorm(hidden_states)
  389. hidden_states = residual + self.dropout(hidden_states)
  390. residual = hidden_states
  391. hidden_states = self.pre_cross_attn_layernorm(hidden_states)
  392. hidden_states, _ = self.cross_attn(
  393. hidden_states=hidden_states,
  394. encoder_hidden_states=encoder_hidden_states,
  395. attention_mask=encoder_attention_mask,
  396. past_key_values=past_key_values,
  397. use_cache=use_cache,
  398. **kwargs,
  399. )
  400. hidden_states = self.post_cross_attn_layernorm(hidden_states)
  401. hidden_states = residual + self.dropout(hidden_states)
  402. residual = hidden_states
  403. hidden_states = self.pre_feedforward_layernorm(hidden_states)
  404. hidden_states = self.mlp(hidden_states)
  405. hidden_states = self.post_feedforward_layernorm(hidden_states)
  406. hidden_states = residual + self.dropout(hidden_states)
  407. return hidden_states
  408. class T5GemmaClassificationHead(nn.Module):
  409. """Head for sentence-level classification tasks."""
  410. def __init__(self, hidden_size: int, num_labels: int, classifier_dropout_rate: float = 0.0):
  411. super().__init__()
  412. self.dropout = nn.Dropout(p=classifier_dropout_rate)
  413. self.out_proj = nn.Linear(hidden_size, num_labels)
  414. def forward(self, hidden_states: torch.Tensor) -> torch.Tensor:
  415. hidden_states = self.dropout(hidden_states)
  416. hidden_states = self.out_proj(hidden_states)
  417. return hidden_states
  418. class T5GemmaLMHead(nn.Module):
  419. """Head for language modeling (generation) tasks."""
  420. def __init__(self, hidden_size: int, vocab_size: int, bias: bool = False):
  421. super().__init__()
  422. self.out_proj = nn.Linear(hidden_size, vocab_size, bias=bias)
  423. def forward(self, hidden_states: torch.Tensor) -> torch.Tensor:
  424. logits = self.out_proj(hidden_states)
  425. return logits
  426. class T5GemmaAttention(nn.Module):
  427. """Multi-headed attention from 'Attention Is All You Need' paper"""
  428. def __init__(self, config: T5GemmaConfig, layer_idx: int):
  429. super().__init__()
  430. self.config = config
  431. self.layer_idx = layer_idx
  432. self.head_dim = getattr(config, "head_dim", config.hidden_size // config.num_attention_heads)
  433. self.num_key_value_groups = config.num_attention_heads // config.num_key_value_heads
  434. self.scaling = config.query_pre_attn_scalar**-0.5
  435. self.attention_dropout = self.config.attention_dropout
  436. self.is_causal = True
  437. self.q_proj = nn.Linear(
  438. config.hidden_size, config.num_attention_heads * self.head_dim, bias=config.attention_bias
  439. )
  440. self.k_proj = nn.Linear(
  441. config.hidden_size, config.num_key_value_heads * self.head_dim, bias=config.attention_bias
  442. )
  443. self.v_proj = nn.Linear(
  444. config.hidden_size, config.num_key_value_heads * self.head_dim, bias=config.attention_bias
  445. )
  446. self.o_proj = nn.Linear(
  447. config.num_attention_heads * self.head_dim, config.hidden_size, bias=config.attention_bias
  448. )
  449. self.attn_logit_softcapping = self.config.attn_logit_softcapping
  450. self.sliding_window = config.sliding_window if config.layer_types[layer_idx] == "sliding_attention" else None
  451. @deprecate_kwarg("past_key_value", new_name="past_key_values", version="4.58")
  452. def forward(
  453. self,
  454. hidden_states: torch.Tensor,
  455. position_embeddings: tuple[torch.Tensor, torch.Tensor],
  456. attention_mask: Optional[torch.Tensor],
  457. past_key_values: Optional[Cache] = None,
  458. cache_position: Optional[torch.LongTensor] = None,
  459. **kwargs: Unpack[FlashAttentionKwargs],
  460. ) -> tuple[torch.Tensor, Optional[torch.Tensor], Optional[tuple[torch.Tensor]]]:
  461. input_shape = hidden_states.shape[:-1]
  462. hidden_shape = (*input_shape, -1, self.head_dim)
  463. query_states = self.q_proj(hidden_states).view(hidden_shape).transpose(1, 2)
  464. key_states = self.k_proj(hidden_states).view(hidden_shape).transpose(1, 2)
  465. value_states = self.v_proj(hidden_states).view(hidden_shape).transpose(1, 2)
  466. cos, sin = position_embeddings
  467. query_states, key_states = apply_rotary_pos_emb(query_states, key_states, cos, sin)
  468. if past_key_values is not None:
  469. # sin and cos are specific to RoPE models; cache_position needed for the static cache
  470. cache_kwargs = {"sin": sin, "cos": cos, "cache_position": cache_position}
  471. key_states, value_states = past_key_values.update(key_states, value_states, self.layer_idx, cache_kwargs)
  472. attention_interface: Callable = eager_attention_forward
  473. if self.config._attn_implementation != "eager":
  474. attention_interface = ALL_ATTENTION_FUNCTIONS[self.config._attn_implementation]
  475. attn_output, attn_weights = attention_interface(
  476. self,
  477. query_states,
  478. key_states,
  479. value_states,
  480. attention_mask,
  481. dropout=self.attention_dropout if self.training else 0.0,
  482. scaling=self.scaling,
  483. sliding_window=self.sliding_window,
  484. softcap=self.attn_logit_softcapping,
  485. **kwargs,
  486. )
  487. attn_output = attn_output.reshape(*input_shape, -1).contiguous()
  488. attn_output = self.o_proj(attn_output)
  489. return attn_output, attn_weights
  490. @auto_docstring
  491. class T5GemmaPreTrainedModel(PreTrainedModel):
  492. config: T5GemmaConfig
  493. base_model_prefix = "model"
  494. supports_gradient_checkpointing = True
  495. _no_split_modules = ["T5GemmaEncoderLayer", "T5GemmaDecoderLayer"]
  496. _skip_keys_device_placement = ["past_key_values"]
  497. _supports_flash_attn = True
  498. _supports_sdpa = True
  499. _supports_flex_attn = True
  500. _can_compile_fullgraph = True
  501. _supports_attention_backend = True
  502. _can_record_outputs = {
  503. "hidden_states": T5GemmaDecoderLayer,
  504. "attentions": T5GemmaAttention,
  505. }
  506. def _init_weights(self, module):
  507. # TODO: support initialization for encoders and decoders separately(?)
  508. super()._init_weights(module)
  509. std = self.config.initializer_range
  510. if isinstance(module, T5GemmaClassificationHead):
  511. scale = module.out_proj.weight.shape[0] ** -0.5
  512. module.out_proj.weight.data.normal_(mean=0.0, std=std * scale)
  513. if hasattr(module.out_proj, "bias") and module.out_proj.bias is not None:
  514. module.out_proj.bias.data.zero_()
  515. elif isinstance(module, T5GemmaLMHead):
  516. if not self.config.tie_word_embeddings:
  517. scale = module.out_proj.weight.shape[0] ** -0.5
  518. module.out_proj.weight.data.normal_(mean=0.0, std=std * scale)
  519. # We initialize with 0s to be 1 centered as the RMSNorm here does (1 + weight)
  520. elif "RMSNorm" in module.__class__.__name__:
  521. module.weight.data.zero_()
  522. def _shift_right(self, input_ids):
  523. """
  524. Shifts input_ids to the right, prepends the decoder_start_token_id, and handles
  525. pad_token_id replacement for labels that were -100.
  526. This is a common preparation step for decoder inputs in sequence-to-sequence models.
  527. """
  528. decoder_start_token_id = self.config.decoder.bos_token_id
  529. pad_token_id = self.config.decoder.pad_token_id
  530. if decoder_start_token_id is None:
  531. raise ValueError("self.model.config.decoder.bos_token_id has to be defined. ")
  532. # shift inputs to the right
  533. shifted_input_ids = input_ids.new_zeros(input_ids.shape)
  534. shifted_input_ids[..., 1:] = input_ids[..., :-1].clone()
  535. shifted_input_ids[..., 0] = decoder_start_token_id
  536. if pad_token_id is None:
  537. raise ValueError("self.model.config.decoder.pad_token_id has to be defined.")
  538. # Is this T5 specific?
  539. # replace possible -100 values in labels by `pad_token_id`
  540. shifted_input_ids.masked_fill_(shifted_input_ids == -100, pad_token_id)
  541. return shifted_input_ids
  542. def bidirectional_mask_function(attention_mask: Optional[torch.Tensor]) -> Callable:
  543. """
  544. This creates bidirectional attention mask.
  545. """
  546. def inner_mask(batch_idx: int, head_idx: int, q_idx: int, kv_idx: int) -> bool:
  547. if attention_mask is None:
  548. return torch.ones((), dtype=torch.bool)
  549. return attention_mask[batch_idx, kv_idx].to(torch.bool)
  550. return inner_mask
  551. def sliding_window_bidirectional_mask_function(sliding_window: int) -> Callable:
  552. """
  553. This creates bidirectional attention mask with sliding window.
  554. """
  555. def inner_mask(batch_idx: int, head_idx: int, q_idx: int, kv_idx: int) -> bool:
  556. return (q_idx - sliding_window < kv_idx) & (kv_idx < q_idx + sliding_window)
  557. return inner_mask
  558. def make_default_2d_attention_mask(
  559. token_ids: Optional[torch.LongTensor],
  560. hidden_states: torch.Tensor,
  561. pad_token_id: Optional[int],
  562. ) -> torch.Tensor:
  563. """Construct the default attention mask."""
  564. if token_ids is not None:
  565. if pad_token_id is None:
  566. raise ValueError("`pad_token_id` is required for padding information.")
  567. attention_mask = (token_ids != pad_token_id).to(hidden_states.device, torch.long)
  568. else:
  569. attention_mask = torch.ones(
  570. (hidden_states.shape[0], hidden_states.shape[1]), device=hidden_states.device, dtype=torch.long
  571. )
  572. return attention_mask
  573. class T5GemmaEncoder(T5GemmaPreTrainedModel):
  574. _can_record_outputs = {
  575. "attentions": T5GemmaSelfAttention,
  576. "hidden_states": T5GemmaEncoderLayer,
  577. }
  578. def __init__(self, config):
  579. super().__init__(config)
  580. self.padding_idx = config.pad_token_id
  581. self.vocab_size = config.vocab_size
  582. self.embed_tokens = nn.Embedding(config.vocab_size, config.hidden_size, self.padding_idx)
  583. self.norm = T5GemmaRMSNorm(config.hidden_size, eps=config.rms_norm_eps)
  584. self.rotary_emb = T5GemmaRotaryEmbedding(config=config)
  585. self.gradient_checkpointing = False
  586. self.layers = nn.ModuleList(
  587. [T5GemmaEncoderLayer(config, layer_idx) for layer_idx in range(config.num_hidden_layers)]
  588. )
  589. self.dropout = nn.Dropout(config.dropout_rate)
  590. # Initialize weights and apply final processing
  591. self.post_init()
  592. @check_model_inputs()
  593. def forward(
  594. self,
  595. input_ids: Optional[torch.LongTensor] = None,
  596. attention_mask: Optional[torch.Tensor] = None,
  597. position_ids: Optional[torch.LongTensor] = None,
  598. inputs_embeds: Optional[torch.FloatTensor] = None,
  599. **kwargs: Unpack[TransformersKwargs],
  600. ) -> BaseModelOutput:
  601. if (input_ids is None) ^ (inputs_embeds is not None):
  602. raise ValueError("You must specify exactly one of input_ids or inputs_embeds")
  603. # As we want to pass `past_key_values=None` explicitly everywhere, we need to pop them from kwargs if present
  604. kwargs.pop("past_key_values", None)
  605. if inputs_embeds is None:
  606. inputs_embeds = self.embed_tokens(input_ids)
  607. cache_position = torch.arange(0, inputs_embeds.shape[1], device=inputs_embeds.device)
  608. if position_ids is None:
  609. position_ids = cache_position.unsqueeze(0)
  610. if attention_mask is None:
  611. attention_mask = make_default_2d_attention_mask(input_ids, inputs_embeds, self.config.pad_token_id)
  612. if not isinstance(self_attn_mask_mapping := attention_mask, dict):
  613. mask_kwargs = {
  614. "config": self.config,
  615. "input_embeds": inputs_embeds,
  616. "attention_mask": attention_mask,
  617. "cache_position": cache_position,
  618. "past_key_values": None,
  619. "position_ids": position_ids,
  620. }
  621. self_attn_mask_mapping = {
  622. "full_attention": create_causal_mask(
  623. **mask_kwargs,
  624. or_mask_function=bidirectional_mask_function(attention_mask),
  625. ),
  626. "sliding_attention": create_sliding_window_causal_mask(
  627. **mask_kwargs,
  628. or_mask_function=sliding_window_bidirectional_mask_function(self.config.sliding_window),
  629. and_mask_function=bidirectional_mask_function(attention_mask),
  630. ),
  631. }
  632. hidden_states = inputs_embeds
  633. position_embeddings = self.rotary_emb(hidden_states, position_ids)
  634. normalizer = torch.tensor(self.config.hidden_size**0.5, dtype=hidden_states.dtype)
  635. hidden_states = hidden_states * normalizer
  636. hidden_states = self.dropout(hidden_states)
  637. for layer_module in self.layers[: self.config.num_hidden_layers]:
  638. hidden_states = layer_module(
  639. hidden_states,
  640. position_embeddings,
  641. self_attn_mask_mapping[layer_module.attention_type],
  642. position_ids,
  643. **kwargs,
  644. )
  645. hidden_states = self.norm(hidden_states)
  646. hidden_states = self.dropout(hidden_states)
  647. return BaseModelOutput(
  648. last_hidden_state=hidden_states,
  649. )
  650. class T5GemmaDecoder(T5GemmaEncoder):
  651. _can_record_outputs = {
  652. "attentions": OutputRecorder(T5GemmaSelfAttention, index=1),
  653. "cross_attentions": OutputRecorder(T5GemmaCrossAttention, index=1),
  654. "hidden_states": T5GemmaDecoderLayer,
  655. }
  656. def __init__(self, config):
  657. super().__init__(config)
  658. self.layers = nn.ModuleList(
  659. [T5GemmaDecoderLayer(config, layer_idx) for layer_idx in range(config.num_hidden_layers)]
  660. )
  661. self.post_init()
  662. @check_model_inputs()
  663. def forward(
  664. self,
  665. input_ids: Optional[torch.LongTensor] = None,
  666. attention_mask: Optional[torch.Tensor] = None,
  667. position_ids: Optional[torch.LongTensor] = None,
  668. past_key_values: Optional[EncoderDecoderCache] = None,
  669. inputs_embeds: Optional[torch.FloatTensor] = None,
  670. use_cache: Optional[bool] = None,
  671. cache_position: Optional[torch.LongTensor] = None,
  672. encoder_hidden_states: Optional[torch.Tensor] = None,
  673. encoder_attention_mask: Optional[torch.Tensor] = None,
  674. **kwargs: Unpack[TransformersKwargs],
  675. ) -> BaseModelOutputWithPastAndCrossAttentions:
  676. if (input_ids is None) ^ (inputs_embeds is not None):
  677. raise ValueError("You must specify exactly one of input_ids or inputs_embeds")
  678. if encoder_hidden_states is None:
  679. raise ValueError("`encoder_hidden_states` must be given in decoder")
  680. if inputs_embeds is None:
  681. inputs_embeds = self.embed_tokens(input_ids)
  682. if not self.training and use_cache and past_key_values is None:
  683. past_key_values = EncoderDecoderCache(DynamicCache(config=self.config), DynamicCache(config=self.config))
  684. if cache_position is None:
  685. past_seen_tokens = past_key_values.get_seq_length() if past_key_values is not None else 0
  686. cache_position = torch.arange(
  687. past_seen_tokens, past_seen_tokens + inputs_embeds.shape[1], device=inputs_embeds.device
  688. )
  689. if position_ids is None:
  690. position_ids = cache_position.unsqueeze(0)
  691. if attention_mask is None and past_key_values is None:
  692. attention_mask = make_default_2d_attention_mask(input_ids, inputs_embeds, self.config.pad_token_id)
  693. if not isinstance(self_attn_mask_mapping := attention_mask, dict):
  694. mask_kwargs = {
  695. "config": self.config,
  696. "input_embeds": inputs_embeds,
  697. "attention_mask": attention_mask,
  698. "cache_position": cache_position,
  699. "past_key_values": past_key_values.self_attention_cache if past_key_values is not None else None,
  700. "position_ids": position_ids,
  701. }
  702. self_attn_mask_mapping = {
  703. "full_attention": create_causal_mask(**mask_kwargs),
  704. "sliding_attention": create_sliding_window_causal_mask(**mask_kwargs),
  705. }
  706. if not isinstance(cross_attn_mask_mapping := encoder_attention_mask, dict):
  707. mask_kwargs = {
  708. "config": self.config,
  709. "input_embeds": encoder_hidden_states,
  710. "attention_mask": encoder_attention_mask,
  711. "cache_position": cache_position,
  712. "past_key_values": None,
  713. "position_ids": None,
  714. }
  715. cross_attn_mask_mapping = {
  716. "full_attention": create_causal_mask(
  717. **mask_kwargs,
  718. or_mask_function=bidirectional_mask_function(encoder_attention_mask),
  719. ),
  720. }
  721. hidden_states = inputs_embeds
  722. position_embeddings = self.rotary_emb(hidden_states, position_ids)
  723. normalizer = torch.tensor(self.config.hidden_size**0.5, dtype=hidden_states.dtype)
  724. hidden_states = hidden_states * normalizer
  725. hidden_states = self.dropout(hidden_states)
  726. for layer_module in self.layers[: self.config.num_hidden_layers]:
  727. hidden_states = layer_module(
  728. hidden_states,
  729. position_embeddings,
  730. self_attn_mask_mapping[layer_module.attention_type],
  731. position_ids,
  732. past_key_values,
  733. use_cache,
  734. cache_position,
  735. encoder_hidden_states,
  736. cross_attn_mask_mapping["full_attention"],
  737. **kwargs,
  738. )
  739. hidden_states = self.norm(hidden_states)
  740. hidden_states = self.dropout(hidden_states)
  741. return BaseModelOutputWithPastAndCrossAttentions(
  742. last_hidden_state=hidden_states,
  743. past_key_values=past_key_values,
  744. )
  745. @auto_docstring
  746. class T5GemmaModel(T5GemmaPreTrainedModel):
  747. def __init__(self, config: T5GemmaConfig):
  748. super().__init__(config)
  749. if not config.is_encoder_decoder:
  750. raise ValueError("T5GemmaModel only support encoder-decoder modeling. Use `T5GemmaEncoderModel` instead.")
  751. self.encoder = T5GemmaEncoder(config.encoder)
  752. self.decoder = T5GemmaDecoder(config.decoder)
  753. self.post_init()
  754. def get_encoder(self):
  755. return self.encoder
  756. def get_input_embeddings(self):
  757. return self.encoder.get_input_embeddings()
  758. def set_input_embeddings(self, new_embeddings):
  759. return self.encoder.set_input_embeddings(new_embeddings)
  760. @can_return_tuple
  761. @auto_docstring
  762. def forward(
  763. self,
  764. input_ids: Optional[torch.LongTensor] = None,
  765. attention_mask: Optional[torch.FloatTensor] = None,
  766. position_ids: Optional[torch.LongTensor] = None,
  767. decoder_input_ids: Optional[torch.LongTensor] = None,
  768. decoder_attention_mask: Optional[torch.BoolTensor] = None,
  769. decoder_position_ids: Optional[torch.LongTensor] = None,
  770. encoder_outputs: Optional[BaseModelOutput] = None,
  771. past_key_values: Optional[EncoderDecoderCache] = None,
  772. inputs_embeds: Optional[torch.Tensor] = None,
  773. decoder_inputs_embeds: Optional[torch.Tensor] = None,
  774. use_cache: Optional[bool] = None,
  775. cache_position: Optional[torch.LongTensor] = None,
  776. **kwargs: Unpack[TransformersKwargs],
  777. ) -> Seq2SeqModelOutput:
  778. r"""
  779. decoder_position_ids (`torch.LongTensor` of shape `(batch_size, decoder_sequence_length)`, *optional*):
  780. Indices of positions of each decoder input sequence tokens in the position embeddings. Selected in the range `[0,
  781. config.decoder.n_positions - 1]`. [What are position IDs?](../glossary#position-ids)
  782. """
  783. if encoder_outputs is None:
  784. encoder_outputs = self.encoder(
  785. input_ids=input_ids,
  786. attention_mask=attention_mask,
  787. position_ids=position_ids,
  788. inputs_embeds=inputs_embeds,
  789. **kwargs,
  790. )
  791. encoder_hidden_states = encoder_outputs.last_hidden_state
  792. decoder_outputs = self.decoder(
  793. input_ids=decoder_input_ids,
  794. attention_mask=decoder_attention_mask,
  795. position_ids=decoder_position_ids,
  796. inputs_embeds=decoder_inputs_embeds,
  797. past_key_values=past_key_values,
  798. encoder_hidden_states=encoder_hidden_states,
  799. encoder_attention_mask=attention_mask,
  800. use_cache=use_cache,
  801. cache_position=cache_position,
  802. **kwargs,
  803. )
  804. return Seq2SeqModelOutput(
  805. last_hidden_state=decoder_outputs.last_hidden_state,
  806. past_key_values=decoder_outputs.past_key_values,
  807. decoder_hidden_states=decoder_outputs.hidden_states
  808. if kwargs.get("output_hidden_states", False)
  809. else (decoder_outputs.last_hidden_state,),
  810. decoder_attentions=decoder_outputs.attentions,
  811. cross_attentions=decoder_outputs.cross_attentions,
  812. encoder_last_hidden_state=encoder_outputs.last_hidden_state,
  813. encoder_hidden_states=encoder_outputs.hidden_states,
  814. encoder_attentions=encoder_outputs.attentions,
  815. )
  816. @auto_docstring
  817. class T5GemmaEncoderModel(T5GemmaPreTrainedModel):
  818. def __init__(self, config: T5GemmaConfig):
  819. super().__init__(config)
  820. if config.is_encoder_decoder:
  821. raise ValueError("T5GemmaEncoderModel only supports encoder-only model. Use `T5GemmaModel` instead.")
  822. self.encoder = T5GemmaEncoder(config.encoder)
  823. self.post_init()
  824. def get_input_embeddings(self):
  825. return self.encoder.get_input_embeddings()
  826. def set_input_embeddings(self, new_embeddings):
  827. return self.encoder.set_input_embeddings(new_embeddings)
  828. @can_return_tuple
  829. @auto_docstring
  830. def forward(
  831. self,
  832. input_ids: Optional[torch.LongTensor] = None,
  833. attention_mask: Optional[torch.FloatTensor] = None,
  834. position_ids: Optional[torch.LongTensor] = None,
  835. inputs_embeds: Optional[torch.Tensor] = None,
  836. **kwargs: Unpack[TransformersKwargs],
  837. ) -> BaseModelOutput:
  838. encoder_outputs = self.encoder(
  839. input_ids=input_ids,
  840. attention_mask=attention_mask,
  841. position_ids=position_ids,
  842. inputs_embeds=inputs_embeds,
  843. **kwargs,
  844. )
  845. return encoder_outputs
  846. class T5GemmaForConditionalGeneration(T5GemmaPreTrainedModel, GenerationMixin):
  847. _tied_weights_keys = ["model.decoder.embed_tokens.weight", "lm_head.out_proj.weight"]
  848. _tp_plan = {"lm_head.out_proj": "colwise_rep"}
  849. _pp_plan = {"lm_head.out_proj": (["hidden_states"], ["logits"])}
  850. def __init__(self, config: T5GemmaConfig):
  851. config.is_encoder_decoder = True
  852. super().__init__(config)
  853. self.model = T5GemmaModel(config)
  854. self.vocab_size = config.decoder.vocab_size
  855. self.lm_head = T5GemmaLMHead(config.decoder.hidden_size, self.vocab_size)
  856. self.loss_type = "ForMaskedLM"
  857. self.post_init()
  858. def set_output_embeddings(self, new_embeddings):
  859. self.lm_head.out_proj = new_embeddings
  860. def get_output_embeddings(self):
  861. return self.lm_head.out_proj
  862. def _tie_weights(self):
  863. # Decoder input and output embeddings are tied.
  864. if self.config.tie_word_embeddings:
  865. self._tie_or_clone_weights(self.lm_head.out_proj, self.get_decoder().get_input_embeddings())
  866. def get_encoder(self):
  867. return self.model.encoder
  868. def get_decoder(self):
  869. return self.model.decoder
  870. @can_return_tuple
  871. @auto_docstring
  872. def forward(
  873. self,
  874. input_ids: Optional[torch.LongTensor] = None,
  875. attention_mask: Optional[torch.FloatTensor] = None,
  876. position_ids: Optional[torch.LongTensor] = None,
  877. decoder_input_ids: Optional[torch.LongTensor] = None,
  878. decoder_attention_mask: Optional[torch.BoolTensor] = None,
  879. decoder_position_ids: Optional[torch.LongTensor] = None,
  880. encoder_outputs: Optional[BaseModelOutput] = None,
  881. past_key_values: Optional[EncoderDecoderCache] = None,
  882. inputs_embeds: Optional[torch.FloatTensor] = None,
  883. decoder_inputs_embeds: Optional[torch.FloatTensor] = None,
  884. labels: Optional[torch.LongTensor] = None,
  885. use_cache: Optional[bool] = None,
  886. cache_position: Optional[torch.LongTensor] = None,
  887. logits_to_keep: Union[int, torch.Tensor] = 0,
  888. **kwargs: Unpack[TransformersKwargs],
  889. ) -> Union[tuple[torch.FloatTensor], Seq2SeqLMOutput]:
  890. r"""
  891. decoder_position_ids (`torch.LongTensor` of shape `(batch_size, decoder_sequence_length)`, *optional*):
  892. Indices of positions of each decoder input sequence tokens in the position embeddings. Selected in the range `[0,
  893. config.decoder.n_positions - 1]`. [What are position IDs?](../glossary#position-ids)
  894. labels (`torch.LongTensor` of shape `(batch_size, sequence_length)`, *optional*):
  895. Labels for computing the masked language modeling loss. Indices should either be in `[0, ...,
  896. config.vocab_size]` or -100 (see `input_ids` docstring). Tokens with indices set to `-100` are ignored
  897. (masked), the loss is only computed for the tokens with labels in `[0, ..., config.vocab_size]`.
  898. """
  899. if labels is not None and decoder_input_ids is None and decoder_inputs_embeds is None:
  900. # get decoder inputs from shifting lm labels to the right
  901. decoder_input_ids = self._shift_right(labels)
  902. decoder_outputs: Seq2SeqModelOutput = self.model(
  903. input_ids=input_ids,
  904. attention_mask=attention_mask,
  905. position_ids=position_ids,
  906. decoder_input_ids=decoder_input_ids,
  907. decoder_attention_mask=decoder_attention_mask,
  908. decoder_position_ids=decoder_position_ids,
  909. encoder_outputs=encoder_outputs,
  910. past_key_values=past_key_values,
  911. inputs_embeds=inputs_embeds,
  912. decoder_inputs_embeds=decoder_inputs_embeds,
  913. use_cache=use_cache,
  914. cache_position=cache_position,
  915. **kwargs,
  916. )
  917. hidden_states = decoder_outputs.last_hidden_state
  918. # Only compute necessary logits, and do not upcast them to float if we are not computing the loss
  919. slice_indices = slice(-logits_to_keep, None) if isinstance(logits_to_keep, int) else logits_to_keep
  920. logits = self.lm_head(hidden_states[:, slice_indices, :])
  921. decoder_config = self.get_decoder().config
  922. if decoder_config.final_logit_softcapping is not None:
  923. logits = logits / decoder_config.final_logit_softcapping
  924. logits = torch.tanh(logits)
  925. logits = logits * decoder_config.final_logit_softcapping
  926. loss = None
  927. if labels is not None:
  928. # Input has right-shifted so we directly perform masked lm loss
  929. loss = self.loss_function(logits, labels, self.vocab_size, **kwargs)
  930. return Seq2SeqLMOutput(
  931. loss=loss,
  932. logits=logits,
  933. past_key_values=decoder_outputs.past_key_values,
  934. decoder_hidden_states=decoder_outputs.decoder_hidden_states,
  935. decoder_attentions=decoder_outputs.decoder_attentions,
  936. cross_attentions=decoder_outputs.cross_attentions,
  937. encoder_last_hidden_state=decoder_outputs.encoder_last_hidden_state,
  938. encoder_hidden_states=decoder_outputs.encoder_hidden_states,
  939. encoder_attentions=decoder_outputs.encoder_attentions,
  940. )
  941. def prepare_decoder_input_ids_from_labels(self, labels: torch.Tensor):
  942. return self._shift_right(labels)
  943. @auto_docstring
  944. class T5GemmaForSequenceClassification(T5GemmaPreTrainedModel):
  945. def __init__(self, config: T5GemmaConfig, is_encoder_decoder: Optional[bool] = None):
  946. r"""
  947. is_encoder_decoder (`Optional`, *optional*):
  948. Whether use encoder_decoder for sequence classification. When set to False, only encoder is used.
  949. """
  950. if is_encoder_decoder is not None:
  951. config.is_encoder_decoder = is_encoder_decoder
  952. super().__init__(config)
  953. self.num_labels = config.num_labels
  954. if config.is_encoder_decoder:
  955. self.model = T5GemmaModel(config)
  956. else:
  957. self.model = T5GemmaEncoderModel(config)
  958. hidden_size = config.encoder.hidden_size
  959. if config.is_encoder_decoder:
  960. hidden_size = config.decoder.hidden_size
  961. classifier_dropout = getattr(config, "classifier_dropout_rate", 0.1)
  962. self.score = T5GemmaClassificationHead(hidden_size, self.num_labels, classifier_dropout)
  963. self.post_init()
  964. def get_input_embeddings(self):
  965. return self.model.get_input_embeddings()
  966. def set_input_embeddings(self, value):
  967. self.model.set_input_embeddings(value)
  968. @can_return_tuple
  969. @auto_docstring
  970. def forward(
  971. self,
  972. input_ids: Optional[torch.LongTensor] = None,
  973. attention_mask: Optional[torch.Tensor] = None,
  974. position_ids: Optional[torch.LongTensor] = None,
  975. decoder_input_ids: Optional[torch.LongTensor] = None,
  976. decoder_attention_mask: Optional[torch.Tensor] = None,
  977. decoder_position_ids: Optional[torch.LongTensor] = None,
  978. encoder_outputs: Optional[BaseModelOutput] = None,
  979. inputs_embeds: Optional[torch.FloatTensor] = None,
  980. decoder_inputs_embeds: Optional[torch.FloatTensor] = None,
  981. labels: Optional[torch.LongTensor] = None,
  982. **kwargs: Unpack[TransformersKwargs],
  983. ) -> SequenceClassifierOutput:
  984. r"""
  985. decoder_position_ids (`torch.LongTensor` of shape `(batch_size, decoder_sequence_length)`, *optional*):
  986. Indices of positions of each decoder input sequence tokens in the position embeddings. Selected in the range `[0,
  987. config.decoder.n_positions - 1]`. [What are position IDs?](../glossary#position-ids)
  988. labels (`torch.LongTensor` of shape `(batch_size,)`, *optional*):
  989. Labels for computing the sequence classification/regression loss. Indices should be in `[0, ...,
  990. config.num_labels - 1]`. If `config.num_labels == 1` a regression loss is computed (Mean-Square loss), If
  991. `config.num_labels > 1` a classification loss is computed (Cross-Entropy).
  992. """
  993. if self.config.is_encoder_decoder and (input_ids is None and inputs_embeds is not None):
  994. raise NotImplementedError(
  995. f"Passing input embeddings is currently not supported for {self.__class__.__name__} in encoder-decoder mode."
  996. )
  997. # Following T5, we automatically creates decoder_input_ids from input_ids if no decoder_input_ids are provided
  998. if self.config.is_encoder_decoder and (decoder_input_ids is None and decoder_inputs_embeds is None):
  999. if input_ids is None:
  1000. raise ValueError(
  1001. "If no `decoder_input_ids` or `decoder_inputs_embeds` are "
  1002. "passed, `input_ids` cannot be `None`. Please pass either "
  1003. "`input_ids` or `decoder_input_ids` or `decoder_inputs_embeds`."
  1004. )
  1005. decoder_input_ids = self._shift_right(input_ids)
  1006. if self.config.is_encoder_decoder:
  1007. outputs: Seq2SeqModelOutput = self.model(
  1008. input_ids,
  1009. attention_mask=attention_mask,
  1010. position_ids=position_ids,
  1011. decoder_input_ids=decoder_input_ids,
  1012. decoder_attention_mask=decoder_attention_mask,
  1013. decoder_position_ids=decoder_position_ids,
  1014. encoder_outputs=encoder_outputs,
  1015. inputs_embeds=inputs_embeds,
  1016. decoder_inputs_embeds=decoder_inputs_embeds,
  1017. use_cache=False,
  1018. **kwargs,
  1019. )
  1020. last_hidden_state = outputs.last_hidden_state
  1021. hidden_states = outputs.decoder_hidden_states
  1022. attentions = outputs.decoder_attentions
  1023. else:
  1024. outputs: BaseModelOutput = self.model(
  1025. input_ids,
  1026. attention_mask=attention_mask,
  1027. position_ids=position_ids,
  1028. inputs_embeds=inputs_embeds,
  1029. **kwargs,
  1030. )
  1031. last_hidden_state = outputs.last_hidden_state
  1032. hidden_states = outputs.hidden_states
  1033. attentions = outputs.attentions
  1034. logits = self.score(last_hidden_state)
  1035. if input_ids is not None:
  1036. batch_size = input_ids.shape[0]
  1037. else:
  1038. batch_size = inputs_embeds.shape[0]
  1039. if self.config.pad_token_id is None and batch_size != 1:
  1040. raise ValueError("Cannot handle batch sizes > 1 if no padding token is defined.")
  1041. if self.config.pad_token_id is None:
  1042. last_non_pad_token = -1
  1043. elif input_ids is not None:
  1044. # To handle both left- and right- padding, we take the rightmost token that is not equal to pad_token_id
  1045. non_pad_mask = (input_ids != self.config.pad_token_id).to(logits.device, torch.int32)
  1046. token_indices = torch.arange(input_ids.shape[-1], device=logits.device, dtype=torch.int32)
  1047. last_non_pad_token = (token_indices * non_pad_mask).argmax(-1)
  1048. if self.config.is_encoder_decoder:
  1049. last_non_pad_token += 1 # due to the right shift.
  1050. last_non_pad_token = torch.clamp(last_non_pad_token, max=decoder_input_ids.shape[-1] - 1)
  1051. else:
  1052. last_non_pad_token = -1
  1053. logger.warning_once(
  1054. f"{self.__class__.__name__} will not detect padding tokens in `inputs_embeds`. Results may be "
  1055. "unexpected if using padding tokens in conjunction with `inputs_embeds.`"
  1056. )
  1057. pooled_logits = logits[torch.arange(batch_size, device=logits.device), last_non_pad_token]
  1058. loss = None
  1059. if labels is not None:
  1060. loss = self.loss_function(logits=logits, labels=labels, pooled_logits=pooled_logits, config=self.config)
  1061. return SequenceClassifierOutput(
  1062. loss=loss,
  1063. logits=pooled_logits,
  1064. hidden_states=hidden_states,
  1065. attentions=attentions,
  1066. )
  1067. @auto_docstring
  1068. class T5GemmaForTokenClassification(T5GemmaPreTrainedModel):
  1069. def __init__(self, config: T5GemmaConfig, is_encoder_decoder: Optional[bool] = None):
  1070. r"""
  1071. is_encoder_decoder (`Optional`, *optional*):
  1072. Whether use encoder_decoder for token classification. When set to False, only encoder is used.
  1073. """
  1074. if is_encoder_decoder is not None:
  1075. config.is_encoder_decoder = is_encoder_decoder
  1076. super().__init__(config)
  1077. self.num_labels = config.num_labels
  1078. if config.is_encoder_decoder:
  1079. self.model = T5GemmaModel(config)
  1080. else:
  1081. self.model = T5GemmaEncoderModel(config)
  1082. hidden_size = config.encoder.hidden_size
  1083. if config.is_encoder_decoder:
  1084. hidden_size = config.decoder.hidden_size
  1085. classifier_dropout = getattr(config, "classifier_dropout_rate", 0.1)
  1086. self.score = T5GemmaClassificationHead(hidden_size, self.num_labels, classifier_dropout)
  1087. self.post_init()
  1088. def get_input_embeddings(self):
  1089. return self.model.get_input_embeddings()
  1090. def set_input_embeddings(self, value):
  1091. self.model.set_input_embeddings(value)
  1092. @can_return_tuple
  1093. @auto_docstring
  1094. def forward(
  1095. self,
  1096. input_ids: Optional[torch.LongTensor] = None,
  1097. attention_mask: Optional[torch.Tensor] = None,
  1098. position_ids: Optional[torch.LongTensor] = None,
  1099. decoder_input_ids: Optional[torch.LongTensor] = None,
  1100. decoder_attention_mask: Optional[torch.Tensor] = None,
  1101. decoder_position_ids: Optional[torch.LongTensor] = None,
  1102. encoder_outputs: Optional[BaseModelOutput] = None,
  1103. inputs_embeds: Optional[torch.FloatTensor] = None,
  1104. decoder_inputs_embeds: Optional[torch.FloatTensor] = None,
  1105. labels: Optional[torch.LongTensor] = None,
  1106. **kwargs: Unpack[TransformersKwargs],
  1107. ) -> TokenClassifierOutput:
  1108. r"""
  1109. decoder_position_ids (`torch.LongTensor` of shape `(batch_size, decoder_sequence_length)`, *optional*):
  1110. Indices of positions of each decoder input sequence tokens in the position embeddings. Selected in the range `[0,
  1111. config.decoder.n_positions - 1]`. [What are position IDs?](../glossary#position-ids)
  1112. labels (`torch.LongTensor` of shape `(batch_size,)`, *optional*):
  1113. Labels for computing the sequence classification/regression loss. Indices should be in `[0, ...,
  1114. config.num_labels - 1]`. If `config.num_labels == 1` a regression loss is computed (Mean-Square loss), If
  1115. `config.num_labels > 1` a classification loss is computed (Cross-Entropy).
  1116. """
  1117. if self.config.is_encoder_decoder and (input_ids is None and inputs_embeds is not None):
  1118. raise NotImplementedError(
  1119. f"Passing input embeddings is currently not supported for {self.__class__.__name__} in encoder-decoder mode."
  1120. )
  1121. if self.config.is_encoder_decoder and (decoder_input_ids is None and decoder_inputs_embeds is None):
  1122. if input_ids is None:
  1123. raise ValueError(
  1124. "If no `decoder_input_ids` or `decoder_inputs_embeds` are "
  1125. "passed, `input_ids` cannot be `None`. Please pass either "
  1126. "`input_ids` or `decoder_input_ids` or `decoder_inputs_embeds`."
  1127. )
  1128. decoder_input_ids = self._shift_right(input_ids)
  1129. if self.config.is_encoder_decoder:
  1130. outputs: Seq2SeqModelOutput = self.model(
  1131. input_ids,
  1132. attention_mask=attention_mask,
  1133. position_ids=position_ids,
  1134. decoder_input_ids=decoder_input_ids,
  1135. decoder_attention_mask=decoder_attention_mask,
  1136. decoder_position_ids=decoder_position_ids,
  1137. encoder_outputs=encoder_outputs,
  1138. inputs_embeds=inputs_embeds,
  1139. decoder_inputs_embeds=decoder_inputs_embeds,
  1140. use_cache=False,
  1141. **kwargs,
  1142. )
  1143. last_hidden_state = outputs.last_hidden_state
  1144. hidden_states = outputs.decoder_hidden_states
  1145. attentions = outputs.decoder_attentions
  1146. else:
  1147. outputs: BaseModelOutput = self.model(
  1148. input_ids,
  1149. attention_mask=attention_mask,
  1150. position_ids=position_ids,
  1151. inputs_embeds=inputs_embeds,
  1152. **kwargs,
  1153. )
  1154. last_hidden_state = outputs.last_hidden_state
  1155. hidden_states = outputs.hidden_states
  1156. attentions = outputs.attentions
  1157. logits = self.score(last_hidden_state)
  1158. loss = None
  1159. if labels is not None:
  1160. loss = self.loss_function(logits, labels, self.config)
  1161. return TokenClassifierOutput(
  1162. loss=loss,
  1163. logits=logits,
  1164. hidden_states=hidden_states,
  1165. attentions=attentions,
  1166. )
  1167. __all__ = [
  1168. "T5GemmaForConditionalGeneration",
  1169. "T5GemmaModel",
  1170. "T5GemmaEncoderModel",
  1171. "T5GemmaPreTrainedModel",
  1172. "T5GemmaForSequenceClassification",
  1173. "T5GemmaForTokenClassification",
  1174. ]