modular_vipllava.py 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278
  1. # coding=utf-8
  2. # Copyright 2023 the HuggingFace Inc. team. All rights reserved.
  3. #
  4. # Licensed under the Apache License, Version 2.0 (the "License");
  5. # you may not use this file except in compliance with the License.
  6. # You may obtain a copy of the License at
  7. #
  8. # http://www.apache.org/licenses/LICENSE-2.0
  9. #
  10. # Unless required by applicable law or agreed to in writing, software
  11. # distributed under the License is distributed on an "AS IS" BASIS,
  12. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. # See the License for the specific language governing permissions and
  14. # limitations under the License.
  15. from typing import Optional, Union
  16. import torch
  17. from torch import nn
  18. from transformers.models.llava.modeling_llava import (
  19. LlavaCausalLMOutputWithPast,
  20. LlavaForConditionalGeneration,
  21. LlavaModel,
  22. LlavaModelOutputWithPast,
  23. LlavaPreTrainedModel,
  24. )
  25. from ...activations import ACT2FN
  26. from ...cache_utils import Cache
  27. from ...utils import auto_docstring, logging
  28. from .configuration_vipllava import VipLlavaConfig
  29. logger = logging.get_logger(__name__)
  30. class VipLlavaModelOutputWithPast(LlavaModelOutputWithPast):
  31. pass
  32. class VipLlavaCausalLMOutputWithPast(LlavaCausalLMOutputWithPast):
  33. pass
  34. class VipLlavaMultiModalProjector(nn.Module):
  35. def __init__(self, config: VipLlavaConfig):
  36. super().__init__()
  37. num_feature_layers = 1 if isinstance(config.vision_feature_layers, int) else len(config.vision_feature_layers)
  38. self.projector_layernorm = nn.LayerNorm(
  39. num_feature_layers * config.vision_config.hidden_size, eps=config.projector_layernorm_eps
  40. )
  41. self.linear_1 = nn.Linear(
  42. num_feature_layers * config.vision_config.hidden_size,
  43. config.text_config.hidden_size,
  44. bias=True,
  45. )
  46. self.act = ACT2FN[config.projector_hidden_act]
  47. self.linear_2 = nn.Linear(config.text_config.hidden_size, config.text_config.hidden_size, bias=True)
  48. def forward(self, hidden_states):
  49. hidden_states = self.projector_layernorm(hidden_states)
  50. hidden_states = self.linear_1(hidden_states)
  51. hidden_states = self.act(hidden_states)
  52. hidden_states = self.linear_2(hidden_states)
  53. return hidden_states
  54. class VipLlavaPreTrainedModel(LlavaPreTrainedModel):
  55. pass
  56. class VipLlavaModel(LlavaModel):
  57. def get_image_features(
  58. self, pixel_values: torch.FloatTensor, vision_feature_layers: Optional[Union[int, list[int]]] = None
  59. ):
  60. """
  61. Obtains image last hidden states from the vision tower and apply multimodal projection.
  62. Args:
  63. pixel_values (`torch.FloatTensor]` of shape `(batch_size, channels, height, width)`)
  64. The tensors corresponding to the input images.
  65. vision_feature_layers (`Union[int, list[int]]`):
  66. The vision feature layer, or the list of indexes of the layers to select
  67. the vision feature.
  68. Returns:
  69. image_features (`torch.Tensor`): Image feature tensor of shape `(num_images, image_length, embed_dim)`).
  70. """
  71. vision_feature_layers = (
  72. vision_feature_layers if vision_feature_layers is not None else self.config.vision_feature_layers
  73. )
  74. image_outputs = self.vision_tower(pixel_values, output_hidden_states=True)
  75. # If multiple feature layers are provided (which is usually the case)
  76. # then the image features are concatenated after the CLS is removed.
  77. if isinstance(vision_feature_layers, int):
  78. image_features = image_outputs.hidden_states[vision_feature_layers][:, 1:]
  79. else:
  80. # Usually, we select the features from index 1: the layers -2, -5, -8, -11 and 6
  81. image_features = [image_outputs.hidden_states[index][:, 1:] for index in vision_feature_layers]
  82. image_features = torch.cat(image_features, dim=-1)
  83. image_features = self.multi_modal_projector(image_features)
  84. return image_features
  85. @auto_docstring
  86. def forward(
  87. self,
  88. input_ids: Optional[torch.LongTensor] = None,
  89. pixel_values: Optional[torch.FloatTensor] = None,
  90. attention_mask: Optional[torch.Tensor] = None,
  91. position_ids: Optional[torch.LongTensor] = None,
  92. past_key_values: Optional[Cache] = None,
  93. inputs_embeds: Optional[torch.FloatTensor] = None,
  94. vision_feature_layers: Optional[Union[int, list[int]]] = None,
  95. use_cache: Optional[bool] = None,
  96. output_attentions: Optional[bool] = None,
  97. output_hidden_states: Optional[bool] = None,
  98. return_dict: Optional[bool] = None,
  99. cache_position: Optional[torch.LongTensor] = None,
  100. **lm_kwargs,
  101. ) -> Union[tuple, VipLlavaModelOutputWithPast]:
  102. r"""
  103. vision_feature_layers (`Union[int, list[int]]`, *optional*):
  104. The vision feature layer, or the list of indexes of the layers to select
  105. the vision feature.
  106. """
  107. output_attentions = output_attentions if output_attentions is not None else self.config.output_attentions
  108. output_hidden_states = (
  109. output_hidden_states if output_hidden_states is not None else self.config.output_hidden_states
  110. )
  111. return_dict = return_dict if return_dict is not None else self.config.use_return_dict
  112. vision_feature_layers = (
  113. vision_feature_layers if vision_feature_layers is not None else self.config.vision_feature_layers
  114. )
  115. if (input_ids is None) ^ (inputs_embeds is not None):
  116. raise ValueError("You must specify exactly one of input_ids or inputs_embeds")
  117. if inputs_embeds is None:
  118. inputs_embeds = self.get_input_embeddings()(input_ids)
  119. if pixel_values is not None:
  120. image_features = self.get_image_features(
  121. pixel_values=pixel_values, vision_feature_layers=vision_feature_layers
  122. )
  123. image_features = image_features.to(inputs_embeds.device, inputs_embeds.dtype)
  124. special_image_mask = self.get_placeholder_mask(
  125. input_ids, inputs_embeds=inputs_embeds, image_features=image_features
  126. )
  127. inputs_embeds = inputs_embeds.masked_scatter(special_image_mask, image_features)
  128. outputs = self.language_model(
  129. attention_mask=attention_mask,
  130. position_ids=position_ids,
  131. past_key_values=past_key_values,
  132. inputs_embeds=inputs_embeds,
  133. use_cache=use_cache,
  134. output_attentions=output_attentions,
  135. output_hidden_states=output_hidden_states,
  136. return_dict=True,
  137. cache_position=cache_position,
  138. **lm_kwargs,
  139. )
  140. output = VipLlavaModelOutputWithPast(
  141. last_hidden_state=outputs.last_hidden_state,
  142. past_key_values=outputs.past_key_values,
  143. hidden_states=outputs.hidden_states,
  144. attentions=outputs.attentions,
  145. image_hidden_states=image_features if pixel_values is not None else None,
  146. )
  147. return output if return_dict else output.to_tuple()
  148. class VipLlavaForConditionalGeneration(LlavaForConditionalGeneration):
  149. def get_image_features(
  150. self, pixel_values: torch.FloatTensor, vision_feature_layers: Optional[Union[int, list[int]]] = None
  151. ):
  152. return self.model.get_image_features(pixel_values=pixel_values, vision_feature_layers=vision_feature_layers)
  153. def forward(
  154. self,
  155. input_ids: Optional[torch.LongTensor] = None,
  156. pixel_values: Optional[torch.FloatTensor] = None,
  157. attention_mask: Optional[torch.Tensor] = None,
  158. position_ids: Optional[torch.LongTensor] = None,
  159. past_key_values: Optional[Cache] = None,
  160. inputs_embeds: Optional[torch.FloatTensor] = None,
  161. vision_feature_layers: Optional[Union[int, list[int]]] = None,
  162. labels: Optional[torch.LongTensor] = None,
  163. use_cache: Optional[bool] = None,
  164. output_attentions: Optional[bool] = None,
  165. output_hidden_states: Optional[bool] = None,
  166. return_dict: Optional[bool] = None,
  167. cache_position: Optional[torch.LongTensor] = None,
  168. logits_to_keep: Union[int, torch.Tensor] = 0,
  169. **lm_kwargs,
  170. ) -> Union[tuple, VipLlavaCausalLMOutputWithPast]:
  171. r"""
  172. vision_feature_layers (`Union[int, list[int]]`, *optional*):
  173. The vision feature layer, or the list of indexes of the layers to select
  174. the vision feature.
  175. labels (`torch.LongTensor` of shape `(batch_size, sequence_length)`, *optional*):
  176. Labels for computing the masked language modeling loss. Indices should either be in `[0, ...,
  177. config.vocab_size]` or -100 (see `input_ids` docstring). Tokens with indices set to `-100` are ignored
  178. (masked), the loss is only computed for the tokens with labels in `[0, ..., config.vocab_size]`.
  179. Example:
  180. ```python
  181. >>> import torch
  182. >>> from PIL import Image
  183. >>> import requests
  184. >>> from transformers import AutoProcessor, VipLlavaForConditionalGeneration
  185. >>> model = VipLlavaForConditionalGeneration.from_pretrained("llava-hf/vip-llava-7b-hf", device_map="auto", dtype=torch.float16)
  186. >>> processor = AutoProcessor.from_pretrained("llava-hf/vip-llava-7b-hf")
  187. >>> prompt = "A chat between a curious human and an artificial intelligence assistant. The assistant gives helpful, detailed, and polite answers to the human's questions.###Human: <image>\n{}###Assistant:"
  188. >>> question = "Can you please describe this image?"
  189. >>> prompt = prompt.format(question)
  190. >>> url = "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/compel-neg.png"
  191. >>> image = Image.open(requests.get(url, stream=True).raw)
  192. >>> inputs = processor(text=text, images=image, return_tensors="pt").to(0, torch.float16)
  193. >>> # Generate
  194. >>> generate_ids = model.generate(**inputs, max_new_tokens=20)
  195. >>> processor.decode(generate_ids[0][len(inputs["input_ids"][0]):], skip_special_tokens=True)
  196. The image features a brown and white cat sitting on a green surface, with a red ball in its
  197. ```"""
  198. output_attentions = output_attentions if output_attentions is not None else self.config.output_attentions
  199. output_hidden_states = (
  200. output_hidden_states if output_hidden_states is not None else self.config.output_hidden_states
  201. )
  202. return_dict = return_dict if return_dict is not None else self.config.use_return_dict
  203. vision_feature_layers = (
  204. vision_feature_layers if vision_feature_layers is not None else self.config.vision_feature_layers
  205. )
  206. outputs = self.model(
  207. input_ids=input_ids,
  208. pixel_values=pixel_values,
  209. attention_mask=attention_mask,
  210. position_ids=position_ids,
  211. past_key_values=past_key_values,
  212. inputs_embeds=inputs_embeds,
  213. use_cache=use_cache,
  214. vision_feature_layers=vision_feature_layers,
  215. output_attentions=output_attentions,
  216. output_hidden_states=output_hidden_states,
  217. return_dict=True,
  218. cache_position=cache_position,
  219. **lm_kwargs,
  220. )
  221. hidden_states = outputs[0]
  222. # Only compute necessary logits, and do not upcast them to float if we are not computing the loss
  223. slice_indices = slice(-logits_to_keep, None) if isinstance(logits_to_keep, int) else logits_to_keep
  224. logits = self.lm_head(hidden_states[:, slice_indices, :])
  225. loss = None
  226. if labels is not None:
  227. loss = self.loss_function(logits=logits, labels=labels, vocab_size=self.config.text_config.vocab_size)
  228. return VipLlavaCausalLMOutputWithPast(
  229. loss=loss,
  230. logits=logits,
  231. past_key_values=outputs.past_key_values,
  232. hidden_states=outputs.hidden_states,
  233. attentions=outputs.attentions,
  234. image_hidden_states=outputs.image_hidden_states,
  235. )
  236. __all__ = ["VipLlavaModel", "VipLlavaForConditionalGeneration", "VipLlavaPreTrainedModel"]