Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+tokenizer.json filter=lfs diff=lfs merge=lfs -text

added_tokens.json

@@ -0,0 +1,24 @@
+{
+  "</tool_call>": 151658,
+  "<tool_call>": 151657,
+  "<|box_end|>": 151649,
+  "<|box_start|>": 151648,
+  "<|endoftext|>": 151643,
+  "<|file_sep|>": 151664,
+  "<|fim_middle|>": 151660,
+  "<|fim_pad|>": 151662,
+  "<|fim_prefix|>": 151659,
+  "<|fim_suffix|>": 151661,
+  "<|im_end|>": 151645,
+  "<|im_start|>": 151644,
+  "<|image_pad|>": 151655,
+  "<|object_ref_end|>": 151647,
+  "<|object_ref_start|>": 151646,
+  "<|quad_end|>": 151651,
+  "<|quad_start|>": 151650,
+  "<|repo_name|>": 151663,
+  "<|video_pad|>": 151656,
+  "<|vision_end|>": 151653,
+  "<|vision_pad|>": 151654,
+  "<|vision_start|>": 151652
+}

attention_mask.py

@@ -0,0 +1,81 @@
+from typing import Optional
+
+import torch
+
+
+def _make_causal_mask(
+    attention_mask: torch.Tensor, dtype: torch.dtype, device: torch.device
+):
+    """
+    Make causal mask used for bi-directional self-attention.
+    """
+    bsz, tgt_len = attention_mask.shape
+    mask = torch.full((tgt_len, tgt_len), torch.tensor(torch.finfo(dtype).min, device=device), device=device)
+    mask_cond = torch.arange(mask.size(-1), device=device)
+    mask.masked_fill_(mask_cond < (mask_cond + 1).view(mask.size(-1), 1), 0)
+    mask = mask.to(dtype)
+
+    return mask[None, None, :, :].expand(bsz, 1, tgt_len, tgt_len)
+
+
+def _make_2dvison_mask(column_mask, dtype: torch.dtype, device: torch.device):
+    """
+    """
+    bsz, seq_length = column_mask.shape
+    cross_mask = torch.zeros((bsz, 1, seq_length, seq_length), dtype=dtype, device=device)
+
+    # 找到连续的 1 的区间
+    start = None
+    for bsz_idx in range(bsz):
+        for i in range(seq_length):
+            if column_mask[bsz_idx, i] == 1:
+                if start is None:
+                    start = i
+            else:
+                if start is not None:
+                    # 填充区间
+                    cross_mask[bsz_idx, 0, start:i, start:i] = 1
+                    start = None
+
+        # 处理最后一个区间
+        if start is not None:
+            cross_mask[bsz_idx, 0, start:seq_length, start:seq_length] = 1
+
+    return cross_mask
+
+
+def _expand_mask(mask: torch.Tensor, dtype: torch.dtype, tgt_len: Optional[int] = None):
+    """
+    Expands attention_mask from `[bsz, seq_len]` to `[bsz, 1, tgt_seq_len, src_seq_len]`.
+    """
+    bsz, src_len = mask.size()
+    tgt_len = tgt_len if tgt_len is not None else src_len
+
+    expanded_mask = mask[:, None, None, :].expand(bsz, 1, tgt_len, src_len).to(dtype)
+
+    inverted_mask = 1.0 - expanded_mask
+
+    return inverted_mask.masked_fill_(inverted_mask.to(torch.bool), torch.finfo(dtype).min)
+
+
+def make_mask(attention_mask: torch.Tensor, dtype: torch.dtype=None, device: torch.device=None, mode: str="default", vision_mask: torch.Tensor=None, ):
+    if dtype is None:
+        dtype = attention_mask.dtype
+    if device is None:
+        device = attention_mask.device      
+    expanded_attn_mask = _expand_mask(attention_mask, dtype).to(device)
+    causal_mask = _make_causal_mask(attention_mask, dtype, device).to(device)
+    if mode == "default":
+        return attention_mask
+    else:
+        assert vision_mask is not None, "vision_mask is None"
+        vision_mask = vision_mask.to(device)
+        bsz, seq_length = attention_mask.shape
+        vision_mask_bg = vision_mask[:, None, :, None]
+        vision_mask_2d = _make_2dvison_mask(vision_mask, dtype, device)
+        if mode == "bidirectional":
+            mask = expanded_attn_mask + causal_mask
+            mask = mask.clone().masked_fill_(vision_mask_2d.to(torch.bool), 0)
+            return mask 
+        else:
+            raise NotImplementedError(f"mode {mode} is not implemented")

aux_vision.py

@@ -0,0 +1,102 @@
+import torch
+import torch.nn as nn
+from transformers import CLIPVisionModel, AutoModel
+
+from .configuration_vora import VoRAConfig
+
+
+class RMSNorm(nn.Module):
+    def __init__(self, dim: int, eps: float = 1e-5):
+        super().__init__()
+        self.weight = nn.Parameter(torch.ones(dim))
+        self.eps = eps
+
+    def forward(self, x: torch.Tensor) -> torch.Tensor:
+        output = self._norm(x.float()).type_as(x)
+        return output * self.weight
+
+    def extra_repr(self) -> str:
+        return f"{tuple(self.weight.shape)}, eps={self.eps}"
+
+    def _norm(self, x: torch.Tensor) -> torch.Tensor:
+        return x * torch.rsqrt(x.pow(2).mean(-1, keepdim=True) + self.eps)
+
+
+class CosineLoss(nn.Module):
+    def __init__(self, reduction='mean'):
+        super(CosineLoss, self).__init__()
+        self.reduction = reduction
+
+    @staticmethod
+    def interpolate_tokens_2d(self, teacher_tokens, target_size):
+        """
+        Interpolate teacher tokens to the target size using bilinear interpolation.
+        """
+        # teacher_tokens shape is (batch_size, height, width, feature_dim)
+        teacher_tokens = teacher_tokens.permute(0, 3, 1, 2)  # Convert to (batch_size, feature_dim, height, width)
+        interpolated = torch.nn.functional.interpolate(teacher_tokens, size=target_size, mode='bilinear', align_corners=True).flatten(2)  # Flatten height and width dimensions
+        return interpolated.permute(0, 2, 1)  # Convert back to (batch_size, new_height * new_width, feature_dim)
+
+    def forward(self, input: torch.Tensor, target: torch.Tensor, input_shape=None, target_shape=None) -> torch.Tensor:
+        if input_shape is not None and target_shape is not None:
+            input = input.reshape((input.shape[0], ) + input_shape + (-1, ))
+            input = self.interpolate_tokens_2d(input, target_shape)
+
+        cos_sim = nn.functional.cosine_similarity(input, target, dim=1)
+        loss = 1 - cos_sim
+
+        if self.reduction == 'mean':
+            return loss.mean()
+        elif self.reduction == 'sum':
+            return loss.sum()
+        else:
+            return loss
+
+
+class AuxVision(nn.Module):
+    def __init__(self,
+        config: VoRAConfig = None,
+    ):
+        super().__init__()
+        self.skip_aux_cls = config.skip_aux_cls  # whether to skip the cls token in ViT
+        # ---------------- Setup Aux Model ----------------
+        if 'clip' in config.aux_vision.lower():
+            self.aux_model = CLIPVisionModel.from_pretrained(config.aux_vision)
+            vision_hidden_size = self.aux_model.vision_model.config.hidden_size
+            num_hidden_layers = self.aux_model.vision_model.config.num_hidden_layers
+        else:
+            self.aux_model = AutoModel.from_pretrained(config.aux_vision, trust_remote_code=True)
+            vision_hidden_size = self.aux_model.config.hidden_size
+            num_hidden_layers = self.aux_model.config.num_hidden_layers
+        for name, param in self.aux_model.named_parameters():
+            param.requires_grad = False
+        # -------------------------------------------------
+
+        # ---------------- Setup Aux Heads ----------------
+        self.aux_layers = list(range(num_hidden_layers))
+        for layer_id in self.aux_layers:
+            self.add_module(f"aux_layer_{layer_id}", self.build_aux_layer(config.hidden_size, vision_hidden_size))
+        # -------------------------------------------------
+
+        self.loss_function = CosineLoss()
+        self.loss_keys = [f"loss_aux_layer_{layer_id}" for layer_id in self.aux_layers]
+
+    def build_aux_layer(self, llm_hidden_size, vit_hidden_size):
+        return nn.Sequential(
+                    RMSNorm(llm_hidden_size),
+                    nn.Linear(
+                        llm_hidden_size,
+                        vit_hidden_size,
+                        bias=False,
+                    )
+                )
+
+    def forward(self, frames, llm_hidden_states, vision_mask):
+        vision_hidden_states = self.aux_model(frames, output_hidden_states=True).hidden_states
+        losses = {}
+        for layer_idx in self.aux_layers:
+            aux_hidden_states = getattr(self, f"aux_layer_{layer_idx}")(llm_hidden_states[layer_idx][vision_mask == 1])
+            start_id = 1 if self.skip_aux_cls else 0
+            aux_loss = self.loss_function(vision_hidden_states[layer_idx][:, start_id:].reshape(aux_hidden_states.shape), aux_hidden_states)
+            losses[f"loss_aux_layer_{layer_idx}"] = aux_loss
+        return losses

chat_template.json

@@ -0,0 +1,3 @@
+{
+  "chat_template": "{% set image_count = namespace(value=0) %}{% set video_count = namespace(value=0) %}{% for message in messages %}{% if loop.first and message['role'] != 'system' %}<|im_start|>system\nYou are a helpful assistant.<|im_end|>\n{% endif %}<|im_start|>{{ message['role'] }}\n{% if message['content'] is string %}{{ message['content'] }}<|im_end|>\n{% else %}{% set text_string = namespace(value='') %}{% for content in message['content'] %}{% if 'text' in content %}{% set text_string.value = content['text'] %}{% endif %}{% endfor %}{% for content in message['content'] %}{% if content['type'] == 'image' or 'image' in content or 'image_url' in content %}{% set image_count.value = image_count.value + 1 %}{% if add_vision_id %}Picture {{ image_count.value }}: {% endif %}{% if '<image>' not in text_string.value %}<image>{% endif %}{% elif content['type'] == 'video' or 'video' in content %}{% set video_count.value = video_count.value + 1 %}{% if add_vision_id %}Video {{ video_count.value }}: {% endif %}<|vision_start|><|video_pad|><|vision_end|>{% elif 'text' in content %}{{ content['text'] }}{% endif %}{% endfor %}<|im_end|>\n{% endif %}{% endfor %}{% if add_generation_prompt %}<|im_start|>assistant\n{% endif %}"
+}

config.json

@@ -0,0 +1,54 @@
+{
+  "architectures": [
+    "VoRAForCausalLM"
+  ],
+  "attention_dropout": 0.0,
+  "auto_map": {
+    "AutoConfig": "configuration_vora.VoRAConfig",
+    "AutoModelForCausalLM": "modeling_vora.VoRAForCausalLM"
+  },
+  "aux_vision": "apple/aimv2-huge-patch14-448",
+  "bos_token_id": 151643,
+  "eos_token_id": 151645,
+  "hidden_act": "silu",
+  "hidden_size": 3584,
+  "image_size": 448,
+  "initializer_range": 0.02,
+  "intermediate_size": 18944,
+  "llm": "Qwen/Qwen2.5-7B-Instruct",
+  "lora": {
+    "layers": 3,
+    "r": 128,
+    "target_modules": [
+      "self_attn.q_proj",
+      "self_attn.k_proj",
+      "self_attn.v_proj",
+      "self_attn.o_proj",
+      "mlp.up_proj",
+      "mlp.gate_proj",
+      "mlp.down_proj"
+    ]
+  },
+  "max_position_embeddings": 32768,
+  "max_window_layers": 28,
+  "model_type": "vora",
+  "num_attention_heads": 28,
+  "num_hidden_layers": 28,
+  "num_key_value_heads": 4,
+  "patch_size": 14,
+  "reuse_aux_vision_embedding_layers": "preprocessor",
+  "rms_norm_eps": 1e-06,
+  "rope_scaling": null,
+  "rope_theta": 1000000.0,
+  "skip_aux_cls": false,
+  "sliding_window": 131072,
+  "tie_word_embeddings": false,
+  "torch_dtype": "bfloat16",
+  "transformers_version": "4.50.3",
+  "use_cache": true,
+  "use_sliding_window": false,
+  "vision_attention_mask": "bidirectional",
+  "vision_embedding": "AIMv2Embedding",
+  "vision_embedding_intermediate_size": 1536,
+  "vocab_size": 152064
+}

configuration_vora.py

@@ -0,0 +1,38 @@
+from typing import Any
+
+from transformers.configuration_utils import PretrainedConfig
+
+__all__ = ["VoRAConfig"]
+
+
+class VoRAConfig(PretrainedConfig):
+    model_type = "vora"
+    _auto_class = "AutoConfig"
+
+    def __init__(
+        self,
+        llm: str = "",
+        aux_vision: str = "",
+        skip_aux_cls: bool = False,
+        reuse_aux_vision_embedding_layers: str = "",
+        lora: dict = {},
+        image_size: int = 448,
+        vision_embedding: str = "AIMv2",
+        vision_embedding_intermediate_size: int = 1536,
+        patch_size: int = 14,
+        vision_attention_mask: str = "bidirectional",
+        rms_norm_eps: float = 1e-5,
+        **kwargs: Any,
+    ):
+        super().__init__(**kwargs)
+        self.llm = llm
+        self.aux_vision = aux_vision
+        self.skip_aux_cls = skip_aux_cls
+        self.reuse_aux_vision_embedding_layers = reuse_aux_vision_embedding_layers
+        self.lora = lora
+        self.image_size = image_size
+        self.vision_embedding = vision_embedding
+        self.vision_embedding_intermediate_size = vision_embedding_intermediate_size
+        self.patch_size = patch_size
+        self.vision_attention_mask = vision_attention_mask
+        self.rms_norm_eps = rms_norm_eps

generation_config.json

@@ -0,0 +1,14 @@
+{
+  "bos_token_id": 151643,
+  "pad_token_id": 151643,
+  "do_sample": true,
+  "eos_token_id": [
+    151645,
+    151643
+  ],
+  "repetition_penalty": 1.05,
+  "temperature": 0.7,
+  "top_p": 0.8,
+  "top_k": 20,
+  "transformers_version": "4.37.0"
+}

global_step30000/bf16_zero_pp_rank_0_mp_rank_00_optim_states.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0b50d041c2ad4752e3d637685f5c1e4b7206bb2edb5996fe5b04f5902dbec3e0
+size 2099159920

global_step30000/mp_rank_00_model_states.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ea146ae9efb83fcb6d95940e607356da519eed072e3278604bfe176e65775e34
+size 33540906252

latest

@@ -0,0 +1 @@
+global_step30000

lora.py

@@ -0,0 +1,104 @@
+import torch
+import types
+import math
+from torch import nn
+import torch.nn.functional as F
+
+
+QWEN2_TARGET_MODULES = [
+    "self_attn.q_proj",
+    "self_attn.k_proj",
+    "self_attn.v_proj",
+    "self_attn.o_proj",
+    "mlp.up_proj",
+    "mlp.gate_proj",
+    "mlp.down_proj",
+]
+
+
+class LoRALayer(nn.Linear):
+    def __init__(
+        self,
+        in_features: int,
+        out_features: int,
+        r: int = 1024,
+        **kwargs
+    ):
+        nn.Linear.__init__(self, in_features, out_features)
+        # we elimate lora_alpha here bc we find it unnecessary in VoRA
+        if r < 0:
+            self.forward = self.naive_forward
+        else:
+            self.lora_A = nn.Linear(in_features, r, bias=False)
+            self.lora_B = nn.Linear(r, out_features, bias=False)
+            nn.init.kaiming_uniform_(self.lora_A.weight, a=math.sqrt(5))
+            nn.init.zeros_(self.lora_B.weight)
+
+    def forward(self, x: torch.Tensor):
+        intermediate = F.linear(x, self.weight, bias=self.bias)
+        result = intermediate + self.lora_B(self.lora_A(x))
+        return result
+
+    def naive_forward(self, x: torch.Tensor):
+        return F.linear(x, self.weight, bias=self.bias)
+
+
+def _get_submodules(self, key):
+    parent = self.get_submodule(".".join(key.split(".")[:-1]))
+    target_name = key.split(".")[-1]
+    target = self.get_submodule(key)
+    return parent, target, target_name
+
+
+def _find_and_replace(self, lora_params):
+    target_modules = lora_params["target_modules"]
+
+    for llm_module_name in target_modules:
+        parent, target, target_name = self._get_submodules(llm_module_name)
+        bias = target.bias is not None
+        vora_layer = LoRALayer(
+            target.in_features,
+            target.out_features,
+            bias=bias,
+            **lora_params
+        )
+        self._replace_module(parent, target_name, vora_layer, target)
+
+
+def _replace_module(self, parent_module, child_name, new_module, old_module):
+    setattr(parent_module, child_name, new_module)
+    new_module.weight = old_module.weight
+    if old_module.bias is not None:
+        new_module.bias = old_module.bias
+    if getattr(old_module, "state", None) is not None:
+        new_module.state = old_module.state
+        new_module.to(old_module.weight.device)
+
+
+def apply_lora(llm, lora_params={"layers": "all", "r": 1024, "target_modules": QWEN2_TARGET_MODULES}):
+    llm_num_layers = llm.config.num_hidden_layers
+    total_layers = lora_params.get("layers", "all")
+
+    # -------------------- validation check ---------------------
+    if isinstance(total_layers, str):
+        if total_layers.lower() == "all":
+            total_layers = list(range(llm_num_layers))
+    else:
+        assert isinstance(total_layers, int), "total_layers must be an integer or 'all'"
+        total_layers = list(range(total_layers))
+    # -------------------- validation check ---------------------
+
+    # -------------------- replace llm layers ---------------------
+    for i in total_layers:
+        llm_layer = llm.model.layers[i]
+        llm_layer._get_submodules = types.MethodType(_get_submodules, llm_layer)
+        llm_layer._find_and_replace = types.MethodType(_find_and_replace, llm_layer)
+        llm_layer._replace_module = types.MethodType(_replace_module, llm_layer)
+        llm_layer._find_and_replace(lora_params)
+
+
+if __name__ == "__main__":
+    from transformers import LlamaForCausalLM, CLIPVisionModel, AutoModel
+    llama = LlamaForCausalLM.from_pretrained("/mnt/bn/wh-data/data/models/llama2_7b_hf_chat")
+    apply_lora(llama)
+    print(llama)

model-00001-of-00004.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6f4eed1c23cef08a6dfcceaea64c8e7368a8a16fe41fd738fb300b4e01af948c
+size 4947144152

model-00002-of-00004.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0d1f561f54d1540e99425dbbf3743697de31839e8f1ed474b58cb88571ac7aa4
+size 4932751496

model-00003-of-00004.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b00b0b5a2fad76fed51ce15c130eed90cd8f110bd4edfd110131880e7e32a539
+size 4330865648

model-00004-of-00004.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:726a5e44beb2a17ee85a87ee0ea466b63197c399bc9171f08e67b921ffa36530
+size 2734467176

model.safetensors.index.json

@@ -0,0 +1,626 @@
+{
+  "metadata": {
+    "total_size": 16945154048
+  },
+  "weight_map": {
+    "aux_vision.aux_layer_0.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_0.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_1.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_1.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_10.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_10.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_11.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_11.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_12.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_12.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_13.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_13.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_14.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_14.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_15.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_15.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_16.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_16.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_17.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_17.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_18.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_18.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_19.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_19.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_2.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_2.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_20.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_20.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_21.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_21.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_22.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_22.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_23.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_23.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_3.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_3.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_4.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_4.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_5.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_5.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_6.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_6.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_7.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_7.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_8.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_8.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_9.0.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_layer_9.1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.preprocessor.patchifier.norm.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.preprocessor.patchifier.proj.bias": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.preprocessor.patchifier.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.preprocessor.pos_embed": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.0.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.0.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.0.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.0.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.0.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.0.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.0.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.1.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.1.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.1.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.1.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.1.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.1.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.1.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.10.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.10.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.10.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.10.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.10.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.10.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.10.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.11.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.11.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.11.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.11.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.11.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.11.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.11.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.12.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.12.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.12.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.12.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.12.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.12.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.12.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.13.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.13.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.13.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.13.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.13.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.13.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.13.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.14.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.14.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.14.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.14.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.14.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.14.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.14.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.15.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.15.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.15.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.15.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.15.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.15.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.15.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.16.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.16.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.16.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.16.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.16.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.16.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.16.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.17.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.17.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.17.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.17.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.17.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.17.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.17.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.18.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.18.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.18.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.18.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.18.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.18.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.18.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.19.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.19.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.19.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.19.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.19.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.19.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.19.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.2.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.2.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.2.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.2.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.2.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.2.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.2.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.20.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.20.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.20.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.20.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.20.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.20.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.20.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.21.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.21.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.21.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.21.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.21.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.21.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.21.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.22.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.22.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.22.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.22.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.22.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.22.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.22.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.23.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.23.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.23.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.23.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.23.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.23.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.23.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.3.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.3.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.3.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.3.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.3.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.3.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.3.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.4.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.4.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.4.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.4.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.4.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.4.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.4.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.5.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.5.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.5.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.5.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.5.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.5.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.5.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.6.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.6.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.6.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.6.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.6.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.6.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.6.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.7.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.7.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.7.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.7.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.7.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.7.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.7.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.8.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.8.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.8.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.8.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.8.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.8.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.8.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.9.attn.proj.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.9.attn.qkv.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.9.mlp.fc1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.9.mlp.fc2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.9.mlp.fc3.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.9.norm_1.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.blocks.9.norm_2.weight": "model-00004-of-00004.safetensors",
+    "aux_vision.aux_model.trunk.post_trunk_norm.weight": "model-00004-of-00004.safetensors",
+    "llm.lm_head.weight": "model-00004-of-00004.safetensors",
+    "llm.model.embed_tokens.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.down_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.down_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.down_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.gate_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.gate_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.gate_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.up_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.up_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.up_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.k_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.k_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.o_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.o_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.o_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.q_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.q_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.v_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.v_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.0.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.down_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.down_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.down_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.gate_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.gate_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.gate_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.up_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.up_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.up_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.k_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.k_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.o_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.o_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.o_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.q_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.q_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.v_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.v_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.1.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.10.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.10.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.11.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.12.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.13.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.14.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.15.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.16.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.17.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.18.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.18.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.18.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.18.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.19.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.19.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.2.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.down_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.down_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.down_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.gate_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.gate_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.gate_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.up_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.up_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.up_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.k_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.k_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.o_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.o_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.o_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.q_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.q_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.v_proj.lora_A.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.v_proj.lora_B.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.2.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.20.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.20.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.21.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.22.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.23.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.24.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.25.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.26.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.input_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.mlp.down_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.mlp.gate_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.mlp.up_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.post_attention_layernorm.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.self_attn.k_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.self_attn.k_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.self_attn.o_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.self_attn.q_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.self_attn.q_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.self_attn.v_proj.bias": "model-00003-of-00004.safetensors",
+    "llm.model.layers.27.self_attn.v_proj.weight": "model-00003-of-00004.safetensors",
+    "llm.model.layers.3.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.3.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.4.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.5.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.6.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.input_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.mlp.down_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.mlp.gate_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.mlp.up_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.post_attention_layernorm.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.7.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.8.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.8.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.8.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.8.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.8.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.8.self_attn.k_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.8.self_attn.k_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.8.self_attn.o_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.8.self_attn.q_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.8.self_attn.q_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.8.self_attn.v_proj.bias": "model-00001-of-00004.safetensors",
+    "llm.model.layers.8.self_attn.v_proj.weight": "model-00001-of-00004.safetensors",
+    "llm.model.layers.9.input_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.mlp.down_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.mlp.gate_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.mlp.up_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.post_attention_layernorm.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.self_attn.k_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.self_attn.k_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.self_attn.o_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.self_attn.q_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.self_attn.q_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.self_attn.v_proj.bias": "model-00002-of-00004.safetensors",
+    "llm.model.layers.9.self_attn.v_proj.weight": "model-00002-of-00004.safetensors",
+    "llm.model.norm.weight": "model-00003-of-00004.safetensors",
+    "vision_embedding.out_proj.weight": "model-00004-of-00004.safetensors",
+    "vision_embedding.patchifier.norm.weight": "model-00004-of-00004.safetensors",
+    "vision_embedding.patchifier.proj.bias": "model-00004-of-00004.safetensors",
+    "vision_embedding.patchifier.proj.weight": "model-00004-of-00004.safetensors",
+    "vision_embedding.pos_embed": "model-00004-of-00004.safetensors"
+  }
+}

modeling_vora.py

@@ -0,0 +1,289 @@
+import torch
+import torch.distributed as dist
+from transformers import (
+    AutoModelForCausalLM,
+    AutoTokenizer,
+    PreTrainedModel,
+    PretrainedConfig,
+)
+
+from .attention_mask import make_mask
+from .configuration_vora import VoRAConfig
+from .vision_embedding import *  # hacking, let transformers find vision_embedding
+from . import vision_embedding as VB
+from .lora import apply_lora
+from .vora_generation_utils import (
+    VoraGenerationMixin,
+    custom_prepare_4d_causal_attention_mask_with_cache_position,
+)
+
+try:
+    from utils import logging
+except:
+    from transformers.utils import logging
+
+
+logger = logging.get_logger(__name__)
+
+
+class VoRAForCausalLM(PreTrainedModel):
+    config_class = VoRAConfig
+    _auto_class = 'AutoModelForCausalLM'
+    supports_gradient_checkpointing = True
+    supports_report_metrics: bool = True
+
+    def __init__(self, config: PretrainedConfig = VoRAConfig()):
+        super().__init__(config)
+        self.config = config
+        # -------------- Setup LLM ---------------------
+        self.llm = AutoModelForCausalLM.from_pretrained(config.llm)
+        self.tokenizer = AutoTokenizer.from_pretrained(config.llm)
+        self.llm.__class__ = type(self.llm.__class__.__name__, (self.llm.__class__, VoraGenerationMixin), {})
+        self.llm.model._prepare_4d_causal_attention_mask_with_cache_position = staticmethod(custom_prepare_4d_causal_attention_mask_with_cache_position)
+
+        self.config.update(self.llm.config.to_dict())
+
+        # -------------- Setup LoRA -------------------
+        if config.lora:
+            for _, param in self.llm.named_parameters():
+                param.requires_grad = False
+            apply_lora(self.llm, config.lora)
+        # ----------------------------------------------
+
+        # ------------ Setup Vision Embedding ----------
+        self.vision_embedding = getattr(VB, config.vision_embedding)(self.config)  # setup after llm so that we know the hiddensize
+        # ----------------------------------------------
+
+        # ------------- Setup Aux Vision ---------------
+        self.enable_aux_vision = False
+        if config.aux_vision:
+            from .aux_vision import AuxVision
+            self.enable_aux_vision = True
+            self.aux_vision = AuxVision(self.config)
+            if config.reuse_aux_vision_embedding_layers:
+                weights = getattr(self.aux_vision.aux_model, config.reuse_aux_vision_embedding_layers).state_dict()
+                msg = self.vision_embedding.load_state_dict(weights, strict=False)
+                logger.info(f"Loaded aux vision weights: {msg}")
+        # ----------------------------------------------
+        # print trainable prameters and total parameters so that we can check if we are loading the correct model
+        logger.info("Trainable parameters:")
+        for name, param in self.named_parameters():
+            if param.requires_grad:
+                logger.info(f"{name}: {param.numel()}")
+        logger.info(f"Total parameters: {sum(p.numel() for p in self.parameters())}")
+
+    def detach_and_gather_loss(self, loss, dtype, device):
+        if not dist.is_initialized():
+            return loss.item()
+        gathered_loss = [torch.tensor(0.0, dtype=loss.dtype).to(device) for _ in range(dist.get_world_size())]
+        dist.all_gather(gathered_loss, loss.detach().clone())
+        avg_gathered_loss = torch.mean(torch.stack(gathered_loss))
+        return avg_gathered_loss.item()
+
+    def _encode_vision(self, images, n_frames):
+        # TODO: we need a more elegant way here to deal with mixed image and pure text training
+        if images.size(0) > 0:
+            vision_embeds = self.vision_embedding(images)
+        else:
+            # FIXME: hacking for deepspeed training
+            # we feed a dummy image tensor (1, 3, H, W) into vision_encoder when training a pure-text batch
+            images = images.new_zeros((1, *images.shape[1:]))
+            vision_embeds = self.vision_embedding(images)[0:0]
+        vision_embeds = vision_embeds.split(n_frames, dim=0)
+        attention_mask = [torch.ones(feature.size()[:-1], dtype=torch.long).to(feature.device) for feature in vision_embeds]
+        vision_targets = [torch.ones(feature.size(), dtype=torch.long).to(feature.device).fill_(-100) for feature in attention_mask]
+
+        image_shapes = images.shape[-2:]
+
+        return vision_embeds, attention_mask, vision_targets, image_shapes
+
+    def _concat_embedding(self, vision_encode_out, batch, vision_placeholder_index, left_padding=False):
+        """ concat vision and text
+        """
+
+        vision_embeds, vision_atts, vision_targets, _ = vision_encode_out
+
+        input_embeds = []
+        attention_mask = []
+        targets = []
+        vision_mask = []  # set vision token as 1, text token as 0
+
+        for cur_batch_idx, cur_input_ids in enumerate(batch["input_ids"]):
+            cur_vision_embeds = vision_embeds[cur_batch_idx]
+            cur_vision_attn = vision_atts[cur_batch_idx]
+            cur_vision_targets = vision_targets[cur_batch_idx]
+            cur_attn_masks = batch["attention_mask"][cur_batch_idx]
+
+            image_token_indices = torch.where(cur_input_ids == vision_placeholder_index)[0]
+            cur_image_num = len(image_token_indices)
+            image_token_indices = list(image_token_indices) + [cur_input_ids.shape[0]]
+
+            cur_input_embeds = []
+            cur_attention_mask = []
+            cur_target = []
+            cur_vision_mask = []
+
+            # convert text before 1st <image> to embedding
+            image_token_index = image_token_indices[0]
+
+            cur_input_embeds.append(
+                self.llm.get_input_embeddings()(cur_input_ids[:image_token_index]),
+            )
+            cur_attention_mask.append(
+                cur_attn_masks[:image_token_index],
+            )
+            cur_vision_mask.append(
+                torch.zeros_like(cur_attn_masks[:image_token_index]).to(cur_attn_masks.device),
+            )
+            if "labels" in batch:
+                cur_target.append(
+                    batch["labels"][cur_batch_idx, :image_token_index],
+                )
+
+            if batch.get("vison_placeholder_mode", 0) == 1:
+                assert cur_image_num <= 1, "multiple video input is not supported"
+                cur_vision_embeds = cur_vision_embeds.unsqueeze(0)
+                cur_vision_attn = cur_vision_attn.unsqueeze(0)
+                cur_vision_targets = cur_vision_targets.unsqueeze(0)
+            assert cur_image_num == len(cur_vision_embeds), \
+                f"Size mismatch! cur_image_num: {cur_image_num}, len(cur_vision_embeds): {len(cur_vision_embeds)} {len(cur_vision_embeds)} \
+                    in {batch['prompt'][cur_batch_idx]} & {batch['gt'][cur_batch_idx]} & {batch['input_ids'][cur_batch_idx]}"
+            # convert each <image> xxx group into embedding
+            text_embedding = self.llm.get_input_embeddings()(cur_input_ids.relu())
+            for i in range(0, cur_image_num):
+                image_token_index = image_token_indices[i]
+                cur_input_embeds.extend([
+                    cur_vision_embeds[i],
+                    text_embedding[image_token_index+1:image_token_indices[i+1]]
+                ])
+                cur_attention_mask.extend([
+                    cur_vision_attn[i],
+                    cur_attn_masks[image_token_index+1:image_token_indices[i+1]]
+                ])
+                cur_vision_mask.extend([
+                    torch.ones_like(cur_vision_attn[i]).to(cur_vision_attn[i].device),
+                    torch.zeros_like(cur_attn_masks[image_token_index+1:image_token_indices[i+1]]).to(cur_vision_attn[i].device),
+                ])
+                if "labels" in batch:
+                    cur_target.extend([
+                        cur_vision_targets[i],
+                        batch["labels"][cur_batch_idx, image_token_index+1:image_token_indices[i+1]],
+                    ])
+
+            input_embeds.append(torch.cat(cur_input_embeds))
+            attention_mask.append(torch.cat(cur_attention_mask))
+            vision_mask.append(torch.cat(cur_vision_mask))
+            if "labels" in batch:
+                targets.append(torch.cat(cur_target))
+
+        # padding
+        n_tokens = [embed.shape[0] for embed in input_embeds]
+
+        max_token = max(n_tokens)
+
+        for i in range(len(input_embeds)):
+            if max_token > n_tokens[i]:
+                self.pad_id = self.tokenizer.pad_token_id or self.tokenizer.eos_token_id
+                pad_token = torch.tensor([self.pad_id] * (max_token - n_tokens[i]))
+                pad_embedding = self.llm.get_input_embeddings()(pad_token.to(batch["attention_mask"][i].device))
+                pad_attention = torch.zeros(pad_embedding.shape[0], dtype=torch.long).to(batch["attention_mask"][i].device)
+                pad_targets = torch.ones(pad_attention.size(), dtype=torch.long).to(batch["attention_mask"][i].device).fill_(-100)
+
+                if left_padding:
+                    input_embeds[i] = torch.cat([pad_embedding, input_embeds[i]])
+                    attention_mask[i] = torch.cat([pad_attention, attention_mask[i]])
+                    vision_mask[i] = torch.cat([pad_attention, vision_mask[i]])
+                    if "labels" in batch:
+                        targets[i] = torch.cat([pad_targets, targets[i]])
+                else:
+                    input_embeds[i] = torch.cat([input_embeds[i], pad_embedding])
+                    attention_mask[i] = torch.cat([attention_mask[i], pad_attention])
+                    vision_mask[i] = torch.cat([vision_mask[i], pad_attention])
+                    if "labels" in batch:
+                        targets[i] = torch.cat([targets[i], pad_targets])
+
+        inputs_embeds = torch.stack(input_embeds, dim=0).type(self.llm.dtype)
+        attention_mask = torch.stack(attention_mask, dim=0)
+        vision_mask = torch.stack(vision_mask, dim=0).to(attention_mask.device)
+
+        if len(targets) > 0:
+            targets = torch.stack(targets, dim=0)
+
+        attention_mask = make_mask(
+            attention_mask,
+            mode=self.config.vision_attention_mask,
+            vision_mask=vision_mask,
+            dtype=inputs_embeds.dtype
+        )
+
+        return inputs_embeds, attention_mask, targets, vision_mask
+
+    def forward(self, **batch):
+        # -------------- Vision/Text Embedding ----------
+        vision_placeholder_index = batch.pop("vision_placeholder_index")
+        images, n_frames = batch["frames"], batch["n_frames"]
+        vision_encode_out = self._encode_vision(images, n_frames)
+        inputs_embeds, attention_mask, targets, vision_mask = self._concat_embedding(
+            vision_encode_out, batch, vision_placeholder_index)
+        # -----------------------------------------------
+
+        outputs = self.llm(
+            inputs_embeds=inputs_embeds,
+            attention_mask=attention_mask,
+            labels=targets,
+            return_dict=True,
+            output_hidden_states=True,
+        )
+
+        llm_loss = outputs.loss
+        device = llm_loss.device
+        dtype = llm_loss.dtype
+
+        metrics = {}
+
+        metrics["llm_loss"] = self.detach_and_gather_loss(llm_loss, dtype, device)
+        if self.enable_aux_vision:
+            if images.size(0) > 0:
+                aux_losses = self.aux_vision(images, outputs.hidden_states, vision_mask)
+            else:
+                # FIXME: hacking for deepspeed training
+                aux_losses = {key: torch.tensor(0., dtype=dtype).to(device) for key in self.aux_vision.loss_keys}
+
+            aux_loss = torch.tensor(0., dtype=dtype).to(device)
+            n_aux = 0
+            for _aux_key, _aux_loss in aux_losses.items():
+                aux_loss += _aux_loss
+                n_aux += 1
+                metrics[_aux_key] = self.detach_and_gather_loss(_aux_loss, dtype, device)
+            aux_loss /= n_aux
+
+            outputs.loss = aux_loss + llm_loss
+        metrics["total_loss"] = self.detach_and_gather_loss(outputs.loss, dtype, device)
+        self.report_metrics(**metrics)
+
+        return outputs
+
+    def generate(self, batch, **generate_params):
+
+        with torch.amp.autocast(
+            enabled=(self.device != torch.device("cpu")),
+            device_type=self.device.type,
+        ):
+            # get vision token
+            vision_placeholder_index = batch.pop("vision_placeholder_index")
+
+            # get vision features
+            images, n_frames = batch["frames"], batch["n_frames"]
+            vision_encode_out = self._encode_vision(images, n_frames)
+
+            inputs_embeds, attention_mask, _, _ = self._concat_embedding(
+                vision_encode_out, batch, vision_placeholder_index, left_padding=False)
+
+        outputs = self.llm.generate(
+            inputs_embeds=inputs_embeds,
+            attention_mask=attention_mask,
+            output_attentions=True,
+            **generate_params
+        )
+
+        return outputs

preprocessor_config.json

@@ -0,0 +1,19 @@
+{
+  "crop_size": 224,
+  "do_center_crop": true,
+  "do_normalize": true,
+  "do_resize": true,
+  "feature_extractor_type": "CLIPFeatureExtractor",
+  "image_mean": [
+    0.48145466,
+    0.4578275,
+    0.40821073
+  ],
+  "image_std": [
+    0.26862954,
+    0.26130258,
+    0.27577711
+  ],
+  "resample": 3,
+  "size": 224
+}

processing_vora.py

@@ -0,0 +1,150 @@
+import torch
+
+from typing import List, Union
+from PIL import Image
+
+from transformers.feature_extraction_utils import BatchFeature
+from transformers.image_utils import ImageInput
+from transformers.processing_utils import ProcessingKwargs, ProcessorMixin, Unpack, _validate_images_text_input_order
+from transformers.tokenization_utils_base import PreTokenizedInput, TextInput
+
+from .modeling_vora import VoRAForCausalLM
+
+
+class VoRAProcessorKwargs(ProcessingKwargs, total=False):
+    _defaults = {
+        "text_kwargs": {
+            "padding": False,
+        },
+        "images_kwargs": {},
+    }
+
+
+class VoRAProcesser(ProcessorMixin):
+    attributes = ["image_processor", "tokenizer"]
+    valid_kwargs = [
+        "chat_template",
+        "image_token",
+    ]
+    image_processor_class = "AutoImageProcessor"
+    tokenizer_class = "AutoTokenizer"
+
+    def __init__(
+        self,
+        image_processor=None,
+        tokenizer=None,
+        chat_template=None,
+        image_token="<image>",  # set the default and let users change if they have peculiar special tokens in rare cases
+        image_token_index = -200,
+        **kwargs,
+    ):
+        self.image_token = image_token
+        self.image_token_index = image_token_index
+        super().__init__(image_processor, tokenizer, chat_template=chat_template)
+
+    def __call__(
+        self,
+        images: ImageInput = None,
+        text: Union[TextInput, PreTokenizedInput, List[TextInput], List[PreTokenizedInput]] = None,
+        **kwargs: Unpack[VoRAProcessorKwargs],
+    ):
+        if images is None and text is None:
+            raise ValueError("You have to specify at least one of `images` or `text`.")
+
+        images, text = _validate_images_text_input_order(images, text)
+        output_kwargs = self._merge_kwargs(
+            VoRAProcessorKwargs,
+            tokenizer_init_kwargs=self.tokenizer.init_kwargs,
+            **kwargs,
+        )
+
+        if images is not None:
+            images = [[self.expand2square(image[0])] for image in images]
+            image_inputs = self.image_processor(images, **output_kwargs["images_kwargs"])
+        else:
+            image_inputs = {}
+        
+        if isinstance(text, str):
+            text = [text]
+        elif not isinstance(text, list) and not isinstance(text[0], str):
+            raise ValueError("Invalid input text. Please provide a string, or a list of strings")
+        
+        input_ids = [self.tokenizer_vision_placeholder(t) for t in text]
+        attention_mask = [
+            [1] * len(input_ids[i]) for i in range(len(input_ids))
+        ]
+
+        text_inputs = dict(
+            input_ids=torch.as_tensor(input_ids, dtype=torch.int64),
+            attention_mask=torch.as_tensor(attention_mask, dtype=torch.int64),
+        )
+        image_inputs['frames'] = image_inputs.pop('pixel_values')
+        image_inputs['n_frames'] = [len(_images) for _images in images]
+        image_inputs['vision_placeholder_index'] = self.image_token_index
+        return BatchFeature(data={**text_inputs, **image_inputs})
+
+    def expand2square(self, pil_img: Image.Image):
+        background_color = (0, 0, 0)
+        width, height = pil_img.size
+        if width == height:
+            return pil_img
+        elif width > height:
+            result = Image.new(pil_img.mode, (width, width), background_color)
+            result.paste(pil_img, (0, (width - height) // 2))
+            return result
+        else:
+            result = Image.new(pil_img.mode, (height, height), background_color)
+            result.paste(pil_img, ((height - width) // 2, 0))
+            return result
+
+    def tokenizer_vision_placeholder(self, prompt, add_bos=False):
+        def join_lists(*lists, sep):
+            result = []
+            for i, lst in enumerate(lists):
+                if i > 0 and sep:
+                    result.extend([sep])
+                result.extend(lst)
+            return result
+
+        prompt_chunks = [self.tokenizer.encode(
+            chunk) for chunk in prompt.split(self.image_token)]
+        input_ids = join_lists(*prompt_chunks, sep=self.image_token_index)
+        if add_bos:
+            input_ids = [self.tokenizer.bos_token_id] + input_ids
+
+        return input_ids
+
+
+if __name__ == '__main__':
+    import torch
+    from transformers import AutoProcessor, AutoModelForCausalLM
+
+    model_name = "/mnt/bn/wh-data/open_source/models/VoRA-7B-Instruct"
+    processor = AutoProcessor.from_pretrained(model_name, trust_remote_code=True)
+    model = AutoModelForCausalLM.from_pretrained(model_name, trust_remote_code=True)
+
+    conversation = [
+        {
+            "role":"user",
+            "content":[
+                {
+                    "type":"image",
+                    "url": "/mnt/bn/wh-data/data/datasets/a_demo/frames/35.jpg"
+                },
+                {
+                    "type":"text",
+                    "text":"<image> Describe this image."
+                }
+            ]
+        }
+    ]
+    model_inputs = processor.apply_chat_template(conversation, add_generation_prompt=True, tokenize=True, return_tensors='pt', return_dict=True).to(model.device)
+
+    gen_kwargs = {"max_new_tokens": 1024, "pad_token_id": processor.tokenizer.eos_token_id}
+    
+    with torch.inference_mode():
+        outputs = model.generate(model_inputs, **gen_kwargs)
+        output_text = processor.tokenizer.batch_decode(
+            outputs, skip_special_tokens=True
+        )
+        print(output_text)

processor_config.json

@@ -0,0 +1,6 @@
+{
+  "image_token": "<image>",
+  "image_token_index": -200,
+  "processor_class": "VoRAProcessing",
+  "auto_map": {"AutoProcessor": "processing_vora.VoRAProcesser"}
+}

rng_state.pth

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:105f982ab14254bd10068585b2b517ad27a13743448d1886bf3871a930461347
+size 14244

scheduler.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:878ab278cdfa3fcccab62e0bd220524657c165f2dedfbcf20d4757c84c62d35f
+size 1064

special_tokens_map.json

@@ -0,0 +1,31 @@
+{
+  "additional_special_tokens": [
+    "<|im_start|>",
+    "<|im_end|>",
+    "<|object_ref_start|>",
+    "<|object_ref_end|>",
+    "<|box_start|>",
+    "<|box_end|>",
+    "<|quad_start|>",
+    "<|quad_end|>",
+    "<|vision_start|>",
+    "<|vision_end|>",
+    "<|vision_pad|>",
+    "<|image_pad|>",
+    "<|video_pad|>"
+  ],
+  "eos_token": {
+    "content": "<|im_end|>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "pad_token": {
+    "content": "<|endoftext|>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  }
+}

tokenizer.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9c5ae00e602b8860cbd784ba82a8aa14e8feecec692e7076590d014d7b7fdafa
+size 11421896

tokenizer_config.json

@@ -0,0 +1,209 @@
+{
+  "add_bos_token": false,
+  "add_prefix_space": false,
+  "added_tokens_decoder": {
+    "151643": {
+      "content": "<|endoftext|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151644": {
+      "content": "<|im_start|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151645": {
+      "content": "<|im_end|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151646": {
+      "content": "<|object_ref_start|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151647": {
+      "content": "<|object_ref_end|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151648": {
+      "content": "<|box_start|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151649": {
+      "content": "<|box_end|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151650": {
+      "content": "<|quad_start|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151651": {
+      "content": "<|quad_end|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151652": {
+      "content": "<|vision_start|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151653": {
+      "content": "<|vision_end|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151654": {
+      "content": "<|vision_pad|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151655": {
+      "content": "<|image_pad|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151656": {
+      "content": "<|video_pad|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "151657": {
+      "content": "<tool_call>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    },
+    "151658": {
+      "content": "</tool_call>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    },
+    "151659": {
+      "content": "<|fim_prefix|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    },
+    "151660": {
+      "content": "<|fim_middle|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    },
+    "151661": {
+      "content": "<|fim_suffix|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    },
+    "151662": {
+      "content": "<|fim_pad|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    },
+    "151663": {
+      "content": "<|repo_name|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    },
+    "151664": {
+      "content": "<|file_sep|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": false
+    }
+  },
+  "additional_special_tokens": [
+    "<|im_start|>",
+    "<|im_end|>",
+    "<|object_ref_start|>",
+    "<|object_ref_end|>",
+    "<|box_start|>",
+    "<|box_end|>",
+    "<|quad_start|>",
+    "<|quad_end|>",
+    "<|vision_start|>",
+    "<|vision_end|>",
+    "<|vision_pad|>",
+    "<|image_pad|>",
+    "<|video_pad|>"
+  ],
+  "bos_token": null,
+  "chat_template": "{%- if tools %}\n    {{- '<|im_start|>system\\n' }}\n    {%- if messages[0]['role'] == 'system' %}\n        {{- messages[0]['content'] }}\n    {%- else %}\n        {{- 'You are Qwen, created by Alibaba Cloud. You are a helpful assistant.' }}\n    {%- endif %}\n    {{- \"\\n\\n# Tools\\n\\nYou may call one or more functions to assist with the user query.\\n\\nYou are provided with function signatures within <tools></tools> XML tags:\\n<tools>\" }}\n    {%- for tool in tools %}\n        {{- \"\\n\" }}\n        {{- tool | tojson }}\n    {%- endfor %}\n    {{- \"\\n</tools>\\n\\nFor each function call, return a json object with function name and arguments within <tool_call></tool_call> XML tags:\\n<tool_call>\\n{\\\"name\\\": <function-name>, \\\"arguments\\\": <args-json-object>}\\n</tool_call><|im_end|>\\n\" }}\n{%- else %}\n    {%- if messages[0]['role'] == 'system' %}\n        {{- '<|im_start|>system\\n' + messages[0]['content'] + '<|im_end|>\\n' }}\n    {%- else %}\n        {{- '<|im_start|>system\\nYou are Qwen, created by Alibaba Cloud. You are a helpful assistant.<|im_end|>\\n' }}\n    {%- endif %}\n{%- endif %}\n{%- for message in messages %}\n    {%- if (message.role == \"user\") or (message.role == \"system\" and not loop.first) or (message.role == \"assistant\" and not message.tool_calls) %}\n        {{- '<|im_start|>' + message.role + '\\n' + message.content + '<|im_end|>' + '\\n' }}\n    {%- elif message.role == \"assistant\" %}\n        {{- '<|im_start|>' + message.role }}\n        {%- if message.content %}\n            {{- '\\n' + message.content }}\n        {%- endif %}\n        {%- for tool_call in message.tool_calls %}\n            {%- if tool_call.function is defined %}\n                {%- set tool_call = tool_call.function %}\n            {%- endif %}\n            {{- '\\n<tool_call>\\n{\"name\": \"' }}\n            {{- tool_call.name }}\n            {{- '\", \"arguments\": ' }}\n            {{- tool_call.arguments | tojson }}\n            {{- '}\\n</tool_call>' }}\n        {%- endfor %}\n        {{- '<|im_end|>\\n' }}\n    {%- elif message.role == \"tool\" %}\n        {%- if (loop.index0 == 0) or (messages[loop.index0 - 1].role != \"tool\") %}\n            {{- '<|im_start|>user' }}\n        {%- endif %}\n        {{- '\\n<tool_response>\\n' }}\n        {{- message.content }}\n        {{- '\\n</tool_response>' }}\n        {%- if loop.last or (messages[loop.index0 + 1].role != \"tool\") %}\n            {{- '<|im_end|>\\n' }}\n        {%- endif %}\n    {%- endif %}\n{%- endfor %}\n{%- if add_generation_prompt %}\n    {{- '<|im_start|>assistant\\n' }}\n{%- endif %}\n",
+  "clean_up_tokenization_spaces": false,
+  "eos_token": "<|im_end|>",
+  "errors": "replace",
+  "extra_special_tokens": {},
+  "model_max_length": 131072,
+  "pad_token": "<|endoftext|>",
+  "processor_class": "VoRAProcessing",
+  "split_special_tokens": false,
+  "tokenizer_class": "Qwen2Tokenizer",
+  "unk_token": null
+}

training_args.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7592ba5d7aa00b95a9d2f6cfba109c8e8d0e76fa4fd1f23a9dfb213893c4c1b4
+size 7032

vision_embedding.py

@@ -0,0 +1,70 @@
+import torch
+import torch.nn as nn
+
+from .configuration_vora import VoRAConfig
+
+
+class RMSNorm(nn.Module):
+    def __init__(self, dim: int, eps: float = 1e-6):
+        super().__init__()
+        self.weight = nn.Parameter(torch.ones(dim))
+        self.eps = eps
+
+    def forward(self, x: torch.Tensor) -> torch.Tensor:
+        output = self._norm(x.float()).type_as(x)
+        return output * self.weight
+
+    def extra_repr(self) -> str:
+        return f"{tuple(self.weight.shape)}, eps={self.eps}"
+
+    def _norm(self, x: torch.Tensor) -> torch.Tensor:
+        return x * torch.rsqrt(x.pow(2).mean(-1, keepdim=True) + self.eps)
+
+
+class AIMv2PatchEmbed(nn.Module):
+    def __init__(self, config: VoRAConfig):
+        super().__init__()
+        self.proj = nn.Conv2d(
+            3,
+            config.vision_embedding_intermediate_size,
+            kernel_size=(config.patch_size, config.patch_size),
+            stride=(config.patch_size, config.patch_size),
+        )
+        self.norm = RMSNorm(config.vision_embedding_intermediate_size, eps=config.rms_norm_eps)
+
+    def forward(self, x: torch.Tensor) -> torch.Tensor:
+        x = self.proj(x).flatten(2).transpose(1, 2)
+        x = self.norm(x)
+        return x
+
+
+class AIMv2Embedding(nn.Module):
+    def __init__(self,
+        config: VoRAConfig = None,
+    ):
+        super().__init__()
+        hidden_size = config.hidden_size
+        num_patches = (config.image_size // config.patch_size) ** 2
+        self.config = config
+
+        self.patchifier = AIMv2PatchEmbed(config)
+        self.pos_embed = nn.Parameter(torch.zeros((1, num_patches, config.vision_embedding_intermediate_size)))
+        self.out_proj = nn.Linear(config.vision_embedding_intermediate_size, hidden_size, bias=False)
+
+    def forward(self, x: torch.Tensor) -> torch.Tensor:
+        B, C, H, W = x.shape
+        h_token = H // self.config.patch_size
+        w_token = W // self.config.patch_size
+        tokens = self.patchifier(x)
+        _, N, _ = tokens.shape
+        pos_embed = self.pos_embed.to(tokens.device)
+
+        if N <= pos_embed.size(1):
+            tokens = tokens + pos_embed[:, :N]
+        else:
+            pos_embed = pos_embed.view(1, int(pos_embed.size(1)**0.5), int(pos_embed.size(1)**0.5), -1).permute(0, 3, 1, 2)
+            pos_embed = nn.functional.interpolate(pos_embed, size=(h_token, w_token), mode='bilinear', align_corners=False).permute(0, 2, 3, 1)
+            pos_embed = pos_embed.view(1, N, pos_embed.size(-1))
+            tokens = tokens + pos_embed
+
+        return self.out_proj(tokens)

vora_generation_utils.py

@@ -0,0 +1,101 @@
+from typing import Any, Dict, Optional
+
+import torch
+from transformers import GenerationMixin
+from transformers.cache_utils import Cache
+from transformers.utils import ModelOutput
+
+
+class VoraGenerationMixin(GenerationMixin):
+
+    def prepare_inputs_for_generation(
+        self,
+        input_ids: torch.LongTensor,
+        past_key_values: Optional[Cache] = None,
+        attention_mask: Optional[torch.LongTensor] = None,
+        inputs_embeds: Optional[torch.FloatTensor] = None,
+        cache_position: Optional[torch.LongTensor] = None,
+        **kwargs,
+    ):
+        if attention_mask is not None and attention_mask.ndim == 4:
+            attention_mask_2d = (attention_mask[:, 0, :, :] == 0).any(dim=1).long().to(attention_mask.device)
+            model_input = super().prepare_inputs_for_generation(
+                input_ids,
+                past_key_values=past_key_values,
+                attention_mask=attention_mask_2d,
+                inputs_embeds=inputs_embeds,
+                cache_position=cache_position,
+                **kwargs,
+            )
+            model_input['attention_mask'] = attention_mask
+            return model_input
+        else:
+            return super().prepare_inputs_for_generation(
+                input_ids,
+                past_key_values=past_key_values,
+                attention_mask=attention_mask,
+                inputs_embeds=inputs_embeds,
+                cache_position=cache_position,
+                **kwargs,
+            )
+
+    def _update_model_kwargs_for_generation(
+        self,
+        outputs: ModelOutput,
+        model_kwargs: Dict[str, Any],
+        is_encoder_decoder: bool = False,
+        num_new_tokens: int = 1,
+    ) -> Dict[str, Any]:
+        if "attention_mask" in model_kwargs and model_kwargs["attention_mask"].ndim == 4:
+            attention_mask = model_kwargs.pop("attention_mask")
+            model_kwargs = super()._update_model_kwargs_for_generation(
+                outputs, model_kwargs, is_encoder_decoder=is_encoder_decoder, num_new_tokens=num_new_tokens
+            )
+            bs, _, seq_len, tgt_len = attention_mask.shape
+            dtype = attention_mask.dtype
+            min_dtype = torch.finfo(dtype).min
+            new_col = attention_mask.new_zeros((bs, 1, seq_len, 1)).fill_(min_dtype)
+            new_row = attention_mask.new_zeros((bs, 1, 1, tgt_len + 1))
+            model_kwargs["attention_mask"] = torch.cat([
+                torch.cat([attention_mask, new_col], dim=-1),
+                new_row
+            ], dim=2)
+            return model_kwargs
+        else:
+            return super()._update_model_kwargs_for_generation(
+                outputs, model_kwargs, is_encoder_decoder=is_encoder_decoder, num_new_tokens=num_new_tokens
+            )
+
+
+def custom_prepare_4d_causal_attention_mask_with_cache_position(
+    attention_mask: torch.Tensor,
+    sequence_length: int,
+    target_length: int,
+    dtype: torch.dtype,
+    device: torch.device,
+    cache_position: torch.Tensor,
+    batch_size: int,
+    **kwargs,
+):
+    if attention_mask is not None and attention_mask.dim() == 4:
+        # In this case we assume that the mask comes already in inverted form and requires no inversion or slicing.
+        causal_mask = attention_mask[:, :, -sequence_length:, -target_length:]
+    else:
+        min_dtype = torch.finfo(dtype).min
+        causal_mask = torch.full(
+            (sequence_length, target_length), fill_value=min_dtype, dtype=dtype, device=device
+        )
+        if sequence_length != 1:
+            causal_mask = torch.triu(causal_mask, diagonal=1)
+        causal_mask *= torch.arange(target_length, device=device) > cache_position.reshape(-1, 1)
+        causal_mask = causal_mask[None, None, :, :].expand(batch_size, 1, -1, -1)
+        if attention_mask is not None:
+            causal_mask = causal_mask.clone()  # copy to contiguous memory for in-place edit
+            mask_length = attention_mask.shape[-1]
+            padding_mask = causal_mask[:, :, :, :mask_length] + attention_mask[:, None, None, :]
+            padding_mask = padding_mask == 0
+            causal_mask[:, :, :, :mask_length] = causal_mask[:, :, :, :mask_length].masked_fill(
+                padding_mask, min_dtype
+            )
+
+    return causal_mask

zero_to_fp32.py

@@ -0,0 +1,760 @@
+#!/usr/bin/env python
+
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: Apache-2.0
+
+# DeepSpeed Team
+
+# This script extracts fp32 consolidated weights from a zero 1, 2 and 3 DeepSpeed checkpoints. It gets
+# copied into the top level checkpoint dir, so the user can easily do the conversion at any point in
+# the future. Once extracted, the weights don't require DeepSpeed and can be used in any
+# application.
+#
+# example:
+#   python zero_to_fp32.py . output_dir/
+#   or
+#   python zero_to_fp32.py . output_dir/ --safe_serialization
+
+import argparse
+import torch
+import glob
+import math
+import os
+import re
+import gc
+import json
+import numpy as np
+from tqdm import tqdm
+from collections import OrderedDict
+from dataclasses import dataclass
+
+# while this script doesn't use deepspeed to recover data, since the checkpoints are pickled with
+# DeepSpeed data structures it has to be available in the current python environment.
+from deepspeed.utils import logger
+from deepspeed.checkpoint.constants import (DS_VERSION, OPTIMIZER_STATE_DICT, SINGLE_PARTITION_OF_FP32_GROUPS,
+                                            FP32_FLAT_GROUPS, ZERO_STAGE, PARTITION_COUNT, PARAM_SHAPES, BUFFER_NAMES,
+                                            FROZEN_PARAM_SHAPES, FROZEN_PARAM_FRAGMENTS)
+
+
+@dataclass
+class zero_model_state:
+    buffers: dict()
+    param_shapes: dict()
+    shared_params: list
+    ds_version: int
+    frozen_param_shapes: dict()
+    frozen_param_fragments: dict()
+
+
+debug = 0
+
+# load to cpu
+device = torch.device('cpu')
+
+
+def atoi(text):
+    return int(text) if text.isdigit() else text
+
+
+def natural_keys(text):
+    '''
+    alist.sort(key=natural_keys) sorts in human order
+    http://nedbatchelder.com/blog/200712/human_sorting.html
+    (See Toothy's implementation in the comments)
+    '''
+    return [atoi(c) for c in re.split(r'(\d+)', text)]
+
+
+def get_model_state_file(checkpoint_dir, zero_stage):
+    if not os.path.isdir(checkpoint_dir):
+        raise FileNotFoundError(f"Directory '{checkpoint_dir}' doesn't exist")
+
+    # there should be only one file
+    if zero_stage <= 2:
+        file = os.path.join(checkpoint_dir, "mp_rank_00_model_states.pt")
+    elif zero_stage == 3:
+        file = os.path.join(checkpoint_dir, "zero_pp_rank_0_mp_rank_00_model_states.pt")
+
+    if not os.path.exists(file):
+        raise FileNotFoundError(f"can't find model states file at '{file}'")
+
+    return file
+
+
+def get_checkpoint_files(checkpoint_dir, glob_pattern):
+    # XXX: need to test that this simple glob rule works for multi-node setup too
+    ckpt_files = sorted(glob.glob(os.path.join(checkpoint_dir, glob_pattern)), key=natural_keys)
+
+    if len(ckpt_files) == 0:
+        raise FileNotFoundError(f"can't find {glob_pattern} files in directory '{checkpoint_dir}'")
+
+    return ckpt_files
+
+
+def get_optim_files(checkpoint_dir):
+    return get_checkpoint_files(checkpoint_dir, "*_optim_states.pt")
+
+
+def get_model_state_files(checkpoint_dir):
+    return get_checkpoint_files(checkpoint_dir, "*_model_states.pt")
+
+
+def parse_model_states(files):
+    zero_model_states = []
+    for file in files:
+        state_dict = torch.load(file, map_location=device, weights_only=False)
+
+        if BUFFER_NAMES not in state_dict:
+            raise ValueError(f"{file} is not a model state checkpoint")
+        buffer_names = state_dict[BUFFER_NAMES]
+        if debug:
+            print("Found buffers:", buffer_names)
+
+        # recover just the buffers while restoring them to fp32 if they were saved in fp16
+        buffers = {k: v.float() for k, v in state_dict["module"].items() if k in buffer_names}
+        param_shapes = state_dict[PARAM_SHAPES]
+
+        # collect parameters that are included in param_shapes
+        param_names = []
+        for s in param_shapes:
+            for name in s.keys():
+                param_names.append(name)
+
+        # update with frozen parameters
+        frozen_param_shapes = state_dict.get(FROZEN_PARAM_SHAPES, None)
+        if frozen_param_shapes is not None:
+            if debug:
+                print(f"Found frozen_param_shapes: {frozen_param_shapes}")
+            param_names += list(frozen_param_shapes.keys())
+
+        # handle shared params
+        shared_params = [[k, v] for k, v in state_dict["shared_params"].items()]
+
+        ds_version = state_dict.get(DS_VERSION, None)
+
+        frozen_param_fragments = state_dict.get(FROZEN_PARAM_FRAGMENTS, None)
+
+        z_model_state = zero_model_state(buffers=buffers,
+                                         param_shapes=param_shapes,
+                                         shared_params=shared_params,
+                                         ds_version=ds_version,
+                                         frozen_param_shapes=frozen_param_shapes,
+                                         frozen_param_fragments=frozen_param_fragments)
+        zero_model_states.append(z_model_state)
+
+    return zero_model_states
+
+
+def parse_optim_states(files, ds_checkpoint_dir):
+    total_files = len(files)
+    state_dicts = []
+    for f in tqdm(files, desc='Loading checkpoint shards'):
+        state_dict = torch.load(f, map_location=device, mmap=True, weights_only=False)
+        # immediately discard the potentially huge 2 optimizer states as we only care for fp32 master weights
+        # and also handle the case where it was already removed by another helper script
+        state_dict["optimizer_state_dict"].pop("optimizer_state_dict", None)
+        state_dicts.append(state_dict)
+
+    if not ZERO_STAGE in state_dicts[0][OPTIMIZER_STATE_DICT]:
+        raise ValueError(f"{files[0]} is not a zero checkpoint")
+    zero_stage = state_dicts[0][OPTIMIZER_STATE_DICT][ZERO_STAGE]
+    world_size = state_dicts[0][OPTIMIZER_STATE_DICT][PARTITION_COUNT]
+
+    # For ZeRO-2 each param group can have different partition_count as data parallelism for expert
+    # parameters can be different from data parallelism for non-expert parameters. So we can just
+    # use the max of the partition_count to get the dp world_size.
+
+    if type(world_size) is list:
+        world_size = max(world_size)
+
+    if world_size != total_files:
+        raise ValueError(
+            f"Expected {world_size} of '*_optim_states.pt' under '{ds_checkpoint_dir}' but found {total_files} files. "
+            "Possibly due to an overwrite of an old checkpoint, or a checkpoint didn't get saved by one or more processes."
+        )
+
+    # the groups are named differently in each stage
+    if zero_stage <= 2:
+        fp32_groups_key = SINGLE_PARTITION_OF_FP32_GROUPS
+    elif zero_stage == 3:
+        fp32_groups_key = FP32_FLAT_GROUPS
+    else:
+        raise ValueError(f"unknown zero stage {zero_stage}")
+
+    fp32_flat_groups = [state_dicts[i][OPTIMIZER_STATE_DICT][fp32_groups_key] for i in range(len(state_dicts))]
+    return zero_stage, world_size, fp32_flat_groups
+
+
+def _get_fp32_state_dict_from_zero_checkpoint(ds_checkpoint_dir, exclude_frozen_parameters):
+    """
+    Returns fp32 state_dict reconstructed from ds checkpoint
+
+    Args:
+        - ``ds_checkpoint_dir``: path to the deepspeed checkpoint folder (where the optimizer files are)
+
+    """
+    print(f"Processing zero checkpoint '{ds_checkpoint_dir}'")
+
+    optim_files = get_optim_files(ds_checkpoint_dir)
+    zero_stage, world_size, fp32_flat_groups = parse_optim_states(optim_files, ds_checkpoint_dir)
+    print(f"Detected checkpoint of type zero stage {zero_stage}, world_size: {world_size}")
+
+    model_files = get_model_state_files(ds_checkpoint_dir)
+
+    zero_model_states = parse_model_states(model_files)
+    print(f'Parsing checkpoint created by deepspeed=={zero_model_states[0].ds_version}')
+
+    if zero_stage <= 2:
+        return _get_fp32_state_dict_from_zero2_checkpoint(world_size, fp32_flat_groups, zero_model_states,
+                                                          exclude_frozen_parameters)
+    elif zero_stage == 3:
+        return _get_fp32_state_dict_from_zero3_checkpoint(world_size, fp32_flat_groups, zero_model_states,
+                                                          exclude_frozen_parameters)
+
+
+def _zero2_merge_frozen_params(state_dict, zero_model_states):
+    if zero_model_states[0].frozen_param_shapes is None or len(zero_model_states[0].frozen_param_shapes) == 0:
+        return
+
+    frozen_param_shapes = zero_model_states[0].frozen_param_shapes
+    frozen_param_fragments = zero_model_states[0].frozen_param_fragments
+
+    if debug:
+        num_elem = sum(s.numel() for s in frozen_param_shapes.values())
+        print(f'rank 0: {FROZEN_PARAM_SHAPES}.numel = {num_elem}')
+
+        wanted_params = len(frozen_param_shapes)
+        wanted_numel = sum(s.numel() for s in frozen_param_shapes.values())
+        avail_numel = sum([p.numel() for p in frozen_param_fragments.values()])
+        print(f'Frozen params: Have {avail_numel} numels to process.')
+        print(f'Frozen params: Need {wanted_numel} numels in {wanted_params} params')
+
+    total_params = 0
+    total_numel = 0
+    for name, shape in frozen_param_shapes.items():
+        total_params += 1
+        unpartitioned_numel = shape.numel()
+        total_numel += unpartitioned_numel
+
+        state_dict[name] = frozen_param_fragments[name]
+
+        if debug:
+            print(f"{name} full shape: {shape} unpartitioned numel {unpartitioned_numel} ")
+
+    print(f"Reconstructed Frozen fp32 state dict with {total_params} params {total_numel} elements")
+
+
+def _has_callable(obj, fn):
+    attr = getattr(obj, fn, None)
+    return callable(attr)
+
+
+def _zero2_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states):
+    param_shapes = zero_model_states[0].param_shapes
+
+    # Reconstruction protocol:
+    #
+    # XXX: document this
+
+    if debug:
+        for i in range(world_size):
+            for j in range(len(fp32_flat_groups[0])):
+                print(f"{FP32_FLAT_GROUPS}[{i}][{j}].shape={fp32_flat_groups[i][j].shape}")
+
+    # XXX: memory usage doubles here (zero2)
+    num_param_groups = len(fp32_flat_groups[0])
+    merged_single_partition_of_fp32_groups = []
+    for i in range(num_param_groups):
+        merged_partitions = [sd[i] for sd in fp32_flat_groups]
+        full_single_fp32_vector = torch.cat(merged_partitions, 0)
+        merged_single_partition_of_fp32_groups.append(full_single_fp32_vector)
+    avail_numel = sum(
+        [full_single_fp32_vector.numel() for full_single_fp32_vector in merged_single_partition_of_fp32_groups])
+
+    if debug:
+        wanted_params = sum([len(shapes) for shapes in param_shapes])
+        wanted_numel = sum([sum(shape.numel() for shape in shapes.values()) for shapes in param_shapes])
+        # not asserting if there is a mismatch due to possible padding
+        print(f"Have {avail_numel} numels to process.")
+        print(f"Need {wanted_numel} numels in {wanted_params} params.")
+
+    # params
+    # XXX: for huge models that can't fit into the host's RAM we will have to recode this to support
+    # out-of-core computing solution
+    total_numel = 0
+    total_params = 0
+    for shapes, full_single_fp32_vector in zip(param_shapes, merged_single_partition_of_fp32_groups):
+        offset = 0
+        avail_numel = full_single_fp32_vector.numel()
+        for name, shape in shapes.items():
+
+            unpartitioned_numel = shape.numel() if _has_callable(shape, 'numel') else math.prod(shape)
+            total_numel += unpartitioned_numel
+            total_params += 1
+
+            if debug:
+                print(f"{name} full shape: {shape} unpartitioned numel {unpartitioned_numel} ")
+            state_dict[name] = full_single_fp32_vector.narrow(0, offset, unpartitioned_numel).view(shape)
+            offset += unpartitioned_numel
+
+        # Z2 started to align to 2*world_size to improve nccl performance. Therefore both offset and
+        # avail_numel can differ by anywhere between 0..2*world_size. Due to two unrelated complex
+        # paddings performed in the code it's almost impossible to predict the exact numbers w/o the
+        # live optimizer object, so we are checking that the numbers are within the right range
+        align_to = 2 * world_size
+
+        def zero2_align(x):
+            return align_to * math.ceil(x / align_to)
+
+        if debug:
+            print(f"original offset={offset}, avail_numel={avail_numel}")
+
+        offset = zero2_align(offset)
+        avail_numel = zero2_align(avail_numel)
+
+        if debug:
+            print(f"aligned  offset={offset}, avail_numel={avail_numel}")
+
+        # Sanity check
+        if offset != avail_numel:
+            raise ValueError(f"consumed {offset} numels out of {avail_numel} - something is wrong")
+
+    print(f"Reconstructed fp32 state dict with {total_params} params {total_numel} elements")
+
+
+def _get_fp32_state_dict_from_zero2_checkpoint(world_size, fp32_flat_groups, zero_model_states,
+                                               exclude_frozen_parameters):
+    state_dict = OrderedDict()
+
+    # buffers
+    buffers = zero_model_states[0].buffers
+    state_dict.update(buffers)
+    if debug:
+        print(f"added {len(buffers)} buffers")
+
+    if not exclude_frozen_parameters:
+        _zero2_merge_frozen_params(state_dict, zero_model_states)
+
+    _zero2_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states)
+
+    # recover shared parameters
+    for pair in zero_model_states[0].shared_params:
+        if pair[1] in state_dict:
+            state_dict[pair[0]] = state_dict[pair[1]]
+
+    return state_dict
+
+
+def zero3_partitioned_param_info(unpartitioned_numel, world_size):
+    remainder = unpartitioned_numel % world_size
+    padding_numel = (world_size - remainder) if remainder else 0
+    partitioned_numel = math.ceil(unpartitioned_numel / world_size)
+    return partitioned_numel, padding_numel
+
+
+def _zero3_merge_frozen_params(state_dict, world_size, zero_model_states):
+    if zero_model_states[0].frozen_param_shapes is None or len(zero_model_states[0].frozen_param_shapes) == 0:
+        return
+
+    if debug:
+        for i in range(world_size):
+            num_elem = sum(s.numel() for s in zero_model_states[i].frozen_param_fragments.values())
+            print(f'rank {i}: {FROZEN_PARAM_SHAPES}.numel = {num_elem}')
+
+        frozen_param_shapes = zero_model_states[0].frozen_param_shapes
+        wanted_params = len(frozen_param_shapes)
+        wanted_numel = sum(s.numel() for s in frozen_param_shapes.values())
+        avail_numel = sum([p.numel() for p in zero_model_states[0].frozen_param_fragments.values()]) * world_size
+        print(f'Frozen params: Have {avail_numel} numels to process.')
+        print(f'Frozen params: Need {wanted_numel} numels in {wanted_params} params')
+
+    total_params = 0
+    total_numel = 0
+    for name, shape in zero_model_states[0].frozen_param_shapes.items():
+        total_params += 1
+        unpartitioned_numel = shape.numel()
+        total_numel += unpartitioned_numel
+
+        param_frags = tuple(model_state.frozen_param_fragments[name] for model_state in zero_model_states)
+        state_dict[name] = torch.cat(param_frags, 0).narrow(0, 0, unpartitioned_numel).view(shape)
+
+        partitioned_numel, partitioned_padding_numel = zero3_partitioned_param_info(unpartitioned_numel, world_size)
+
+        if debug:
+            print(
+                f"Frozen params: {total_params} {name} full shape: {shape} partition0 numel={partitioned_numel} partitioned_padding_numel={partitioned_padding_numel}"
+            )
+
+    print(f"Reconstructed Frozen fp32 state dict with {total_params} params {total_numel} elements")
+
+
+class GatheredTensor:
+    """
+    A pseudo tensor that collects partitioned weights.
+    It is more memory efficient when there are multiple groups.
+    """
+
+    def __init__(self, flat_groups, flat_groups_offset, offset, partitioned_numel, shape):
+        self.flat_groups = flat_groups
+        self.flat_groups_offset = flat_groups_offset
+        self.offset = offset
+        self.partitioned_numel = partitioned_numel
+        self.shape = shape
+        self.dtype = self.flat_groups[0][0].dtype
+
+    def contiguous(self):
+        """
+        Merge partitioned weights from flat_groups into a single tensor.
+        """
+        end_idx = self.offset + self.partitioned_numel
+        world_size = len(self.flat_groups)
+        pad_flat_param_chunks = []
+
+        for rank_i in range(world_size):
+            # for each rank, we need to collect weights from related group/groups
+            flat_groups_at_rank_i = self.flat_groups[rank_i]
+            start_group_id = None
+            end_group_id = None
+            for group_id in range(len(self.flat_groups_offset)):
+                if self.flat_groups_offset[group_id] <= self.offset < self.flat_groups_offset[group_id + 1]:
+                    start_group_id = group_id
+                if self.flat_groups_offset[group_id] < end_idx <= self.flat_groups_offset[group_id + 1]:
+                    end_group_id = group_id
+                    break
+            # collect weights from related group/groups
+            for group_id in range(start_group_id, end_group_id + 1):
+                flat_tensor = flat_groups_at_rank_i[group_id]
+                start_offset = self.offset - self.flat_groups_offset[group_id]
+                end_offset = min(end_idx, self.flat_groups_offset[group_id + 1]) - self.flat_groups_offset[group_id]
+                pad_flat_param_chunks.append(flat_tensor[start_offset:end_offset])
+
+        # collect weights from all ranks
+        pad_flat_param = torch.cat(pad_flat_param_chunks, dim=0)
+        param = pad_flat_param[:self.shape.numel()].view(self.shape).contiguous()
+        return param
+
+
+def _zero3_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states):
+    param_shapes = zero_model_states[0].param_shapes
+    avail_numel = sum([flat_group.numel() for flat_group in fp32_flat_groups[0]]) * world_size
+
+    # Reconstruction protocol: For zero3 we need to zip the partitions together at boundary of each
+    # param, re-consolidating each param, while dealing with padding if any
+
+    # merge list of dicts, preserving order
+    param_shapes = {k: v for d in param_shapes for k, v in d.items()}
+
+    if debug:
+        for i in range(world_size):
+            print(f"{FP32_FLAT_GROUPS}[{i}].shape={fp32_flat_groups[i].shape}")
+
+        wanted_params = len(param_shapes)
+        wanted_numel = sum(shape.numel() for shape in param_shapes.values())
+        # not asserting if there is a mismatch due to possible padding
+        avail_numel = fp32_flat_groups[0].numel() * world_size
+        print(f"Trainable params: Have {avail_numel} numels to process.")
+        print(f"Trainable params: Need {wanted_numel} numels in {wanted_params} params.")
+
+    # params
+    # XXX: for huge models that can't fit into the host's RAM we will have to recode this to support
+    # out-of-core computing solution
+    offset = 0
+    total_numel = 0
+    total_params = 0
+    flat_groups_offset = [0] + list(np.cumsum([flat_tensor.numel() for flat_tensor in fp32_flat_groups[0]]))
+    for name, shape in tqdm(param_shapes.items(), desc='Gathering sharded weights'):
+        unpartitioned_numel = shape.numel()
+        total_numel += unpartitioned_numel
+        total_params += 1
+        partitioned_numel, partitioned_padding_numel = zero3_partitioned_param_info(unpartitioned_numel, world_size)
+
+        if debug:
+            print(
+                f"Trainable params: {total_params} {name} full shape: {shape} partition0 numel={partitioned_numel} partitioned_padding_numel={partitioned_padding_numel}"
+            )
+
+        # memory efficient tensor
+        tensor = GatheredTensor(fp32_flat_groups, flat_groups_offset, offset, partitioned_numel, shape)
+        state_dict[name] = tensor
+        offset += partitioned_numel
+
+    offset *= world_size
+
+    # Sanity check
+    if offset != avail_numel:
+        raise ValueError(f"consumed {offset} numels out of {avail_numel} - something is wrong")
+
+    print(f"Reconstructed Trainable fp32 state dict with {total_params} params {total_numel} elements")
+
+
+def _get_fp32_state_dict_from_zero3_checkpoint(world_size, fp32_flat_groups, zero_model_states,
+                                               exclude_frozen_parameters):
+    state_dict = OrderedDict()
+
+    # buffers
+    buffers = zero_model_states[0].buffers
+    state_dict.update(buffers)
+    if debug:
+        print(f"added {len(buffers)} buffers")
+
+    if not exclude_frozen_parameters:
+        _zero3_merge_frozen_params(state_dict, world_size, zero_model_states)
+
+    _zero3_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states)
+
+    # recover shared parameters
+    for pair in zero_model_states[0].shared_params:
+        if pair[1] in state_dict:
+            state_dict[pair[0]] = state_dict[pair[1]]
+
+    return state_dict
+
+
+def to_torch_tensor(state_dict, return_empty_tensor=False):
+    """
+    Convert state_dict of GatheredTensor to torch tensor
+    """
+    torch_state_dict = {}
+    converted_tensors = {}
+    for name, tensor in state_dict.items():
+        tensor_id = id(tensor)
+        if tensor_id in converted_tensors:  # shared tensors
+            shared_tensor = torch_state_dict[converted_tensors[tensor_id]]
+            torch_state_dict[name] = shared_tensor
+        else:
+            converted_tensors[tensor_id] = name
+            if return_empty_tensor:
+                torch_state_dict[name] = torch.empty(tensor.shape, dtype=tensor.dtype)
+            else:
+                torch_state_dict[name] = tensor.contiguous()
+    return torch_state_dict
+
+
+def get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir,
+                                             tag=None,
+                                             exclude_frozen_parameters=False,
+                                             lazy_mode=False):
+    """
+    Convert ZeRO 2 or 3 checkpoint into a single fp32 consolidated state_dict that can be loaded with
+    ``load_state_dict()`` and used for training without DeepSpeed or shared with others, for example
+    via a model hub.
+
+    Args:
+        - ``checkpoint_dir``: path to the desired checkpoint folder
+        - ``tag``: checkpoint tag used as a unique identifier for checkpoint. If not provided will attempt to load tag in 'latest' file. e.g., ``global_step14``
+        - ``exclude_frozen_parameters``: exclude frozen parameters
+        - ``lazy_mode``: get state_dict in lazy mode. It returns a dict of pesduo tensor instead of torch tensor, which is more memory efficient.
+          Convert the pesduo tensor to torch tensor by ``.contiguous()``
+
+    Returns:
+        - pytorch ``state_dict``
+
+    A typical usage might be ::
+
+        from deepspeed.utils.zero_to_fp32 import get_fp32_state_dict_from_zero_checkpoint
+        # do the training and checkpoint saving
+        state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir) # already on cpu
+        model = model.cpu() # move to cpu
+        model.load_state_dict(state_dict)
+        # submit to model hub or save the model to share with others
+
+    In this example the ``model`` will no longer be usable in the deepspeed context of the same
+    application. i.e. you will need to re-initialize the deepspeed engine, since
+    ``model.load_state_dict(state_dict)`` will remove all the deepspeed magic from it.
+
+    If you want it all done for you, use ``load_state_dict_from_zero_checkpoint`` instead.
+
+    Note: the above usage may not work if your application doesn't have sufficient free CPU memory.
+    You may need to use the offline approach using the ``zero_to_fp32.py`` script that is saved with
+    the checkpoint. Or you can load state_dict in lazy mode ::
+
+        from deepspeed.utils.zero_to_fp32 import get_fp32_state_dict_from_zero_checkpoint
+        state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir, lazy_mode=True) # not on cpu
+        for name, lazy_tensor in state_dict.item():
+            tensor = lazy_tensor.contiguous()  # to cpu
+            print(name, tensor)
+            # del tensor to release memory if it no longer in use
+    """
+    if tag is None:
+        latest_path = os.path.join(checkpoint_dir, 'latest')
+        if os.path.isfile(latest_path):
+            with open(latest_path, 'r') as fd:
+                tag = fd.read().strip()
+        else:
+            raise ValueError(f"Unable to find 'latest' file at {latest_path}")
+
+    ds_checkpoint_dir = os.path.join(checkpoint_dir, tag)
+
+    if not os.path.isdir(ds_checkpoint_dir):
+        raise FileNotFoundError(f"Directory '{ds_checkpoint_dir}' doesn't exist")
+
+    state_dict = _get_fp32_state_dict_from_zero_checkpoint(ds_checkpoint_dir, exclude_frozen_parameters)
+    if lazy_mode:
+        return state_dict
+    else:
+        return to_torch_tensor(state_dict)
+
+
+def convert_zero_checkpoint_to_fp32_state_dict(checkpoint_dir,
+                                               output_dir,
+                                               max_shard_size="5GB",
+                                               safe_serialization=False,
+                                               tag=None,
+                                               exclude_frozen_parameters=False):
+    """
+    Convert ZeRO 2 or 3 checkpoint into a single fp32 consolidated ``state_dict`` file that can be
+    loaded with ``torch.load(file)`` + ``load_state_dict()`` and used for training without DeepSpeed.
+
+    Args:
+        - ``checkpoint_dir``: path to the desired checkpoint folder. (one that contains the tag-folder, like ``global_step14``)
+        - ``output_dir``: directory to the pytorch fp32 state_dict output files
+        - ``max_shard_size``: the maximum size for a checkpoint before being sharded, default value is 5GB
+        - ``safe_serialization``:  whether to save the model using `safetensors` or the traditional PyTorch way (that uses `pickle`).
+        - ``tag``: checkpoint tag used as a unique identifier for checkpoint. If not provided will attempt to load tag in the file named ``latest`` in the checkpoint folder, e.g., ``global_step14``
+        - ``exclude_frozen_parameters``: exclude frozen parameters
+    """
+
+    # Dependency pre-check
+    if safe_serialization:
+        try:
+            from safetensors.torch import save_file
+        except ImportError:
+            print('If you want to use `safe_serialization`, please `pip install safetensors`')
+            raise
+    if max_shard_size is not None:
+        try:
+            from huggingface_hub import split_torch_state_dict_into_shards
+        except ImportError:
+            print('If you want to use `max_shard_size`, please `pip install huggingface_hub`')
+            raise
+
+    # Convert zero checkpoint to state_dict
+    state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir,
+                                                          tag,
+                                                          exclude_frozen_parameters,
+                                                          lazy_mode=True)
+
+    # Shard the model if it is too big.
+    weights_name = "model.safetensors" if safe_serialization else "pytorch_model.bin"
+    if max_shard_size is not None:
+        filename_pattern = weights_name.replace(".bin", "{suffix}.bin").replace(".safetensors", "{suffix}.safetensors")
+        # an memory-efficient approach for sharding
+        empty_state_dict = to_torch_tensor(state_dict, return_empty_tensor=True)
+        state_dict_split = split_torch_state_dict_into_shards(empty_state_dict,
+                                                              filename_pattern=filename_pattern,
+                                                              max_shard_size=max_shard_size)
+    else:
+        from collections import namedtuple
+        StateDictSplit = namedtuple("StateDictSplit", ["is_sharded", "filename_to_tensors"])
+        state_dict_split = StateDictSplit(is_sharded=False,
+                                          filename_to_tensors={weights_name: list(state_dict.keys())})
+
+    # Save the model by shard
+    os.makedirs(output_dir, exist_ok=True)
+    filename_to_tensors = state_dict_split.filename_to_tensors.items()
+    for shard_file, tensors in tqdm(filename_to_tensors, desc="Saving checkpoint shards"):
+        shard_state_dict = {tensor_name: state_dict[tensor_name] for tensor_name in tensors}
+        shard_state_dict = to_torch_tensor(shard_state_dict)
+        output_path = os.path.join(output_dir, shard_file)
+        if safe_serialization:
+            save_file(shard_state_dict, output_path, metadata={"format": "pt"})
+        else:
+            torch.save(shard_state_dict, output_path)
+        # release the memory of current shard
+        for tensor_name in list(shard_state_dict.keys()):
+            del state_dict[tensor_name]
+            del shard_state_dict[tensor_name]
+        del shard_state_dict
+        gc.collect()
+
+    # Save index if sharded
+    if state_dict_split.is_sharded:
+        index = {
+            "metadata": state_dict_split.metadata,
+            "weight_map": state_dict_split.tensor_to_filename,
+        }
+        save_index_file = "model.safetensors.index.json" if safe_serialization else "pytorch_model.bin.index.json"
+        save_index_file = os.path.join(output_dir, save_index_file)
+        with open(save_index_file, "w", encoding="utf-8") as f:
+            content = json.dumps(index, indent=2, sort_keys=True) + "\n"
+            f.write(content)
+
+
+def load_state_dict_from_zero_checkpoint(model, checkpoint_dir, tag=None):
+    """
+    1. Put the provided model to cpu
+    2. Convert ZeRO 2 or 3 checkpoint into a single fp32 consolidated ``state_dict``
+    3. Load it into the provided model
+
+    Args:
+        - ``model``: the model object to update
+        - ``checkpoint_dir``: path to the desired checkpoint folder. (one that contains the tag-folder, like ``global_step14``)
+        - ``tag``: checkpoint tag used as a unique identifier for checkpoint. If not provided will attempt to load tag in the file named ``latest`` in the checkpoint folder, e.g., ``global_step14``
+
+    Returns:
+        - ``model`: modified model
+
+    Make sure you have plenty of CPU memory available before you call this function. If you don't
+    have enough use the ``zero_to_fp32.py`` utility to do the conversion. You will find it
+    conveniently placed for you in the checkpoint folder.
+
+    A typical usage might be ::
+
+        from deepspeed.utils.zero_to_fp32 import load_state_dict_from_zero_checkpoint
+        model = load_state_dict_from_zero_checkpoint(trainer.model, checkpoint_dir)
+        # submit to model hub or save the model to share with others
+
+    Note, that once this was run, the ``model`` will no longer be usable in the deepspeed context
+    of the same application. i.e. you will need to re-initialize the deepspeed engine, since
+    ``model.load_state_dict(state_dict)`` will remove all the deepspeed magic from it.
+
+    """
+    logger.info(f"Extracting fp32 weights")
+    state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir, tag)
+
+    logger.info(f"Overwriting model with fp32 weights")
+    model = model.cpu()
+    model.load_state_dict(state_dict, strict=False)
+
+    return model
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("checkpoint_dir",
+                        type=str,
+                        help="path to the desired checkpoint folder, e.g., path/checkpoint-12")
+    parser.add_argument("output_dir",
+                        type=str,
+                        help="directory to the pytorch fp32 state_dict output files"
+                        "(e.g. path/checkpoint-12-output/)")
+    parser.add_argument(
+        "--max_shard_size",
+        type=str,
+        default="5GB",
+        help="The maximum size for a checkpoint before being sharded. Checkpoints shard will then be each of size"
+        "lower than this size. If expressed as a string, needs to be digits followed by a unit (like `5MB`"
+        "We default it to 5GB in order for models to be able to run easily on free-tier google colab instances"
+        "without CPU OOM issues.")
+    parser.add_argument(
+        "--safe_serialization",
+        default=False,
+        action='store_true',
+        help="Whether to save the model using `safetensors` or the traditional PyTorch way (that uses `pickle`).")
+    parser.add_argument("-t",
+                        "--tag",
+                        type=str,
+                        default=None,
+                        help="checkpoint tag used as a unique identifier for checkpoint. e.g., global_step1")
+    parser.add_argument("--exclude_frozen_parameters", action='store_true', help="exclude frozen parameters")
+    parser.add_argument("-d", "--debug", action='store_true', help="enable debug")
+    args = parser.parse_args()
+
+    debug = args.debug
+
+    convert_zero_checkpoint_to_fp32_state_dict(args.checkpoint_dir,
+                                               args.output_dir,
+                                               max_shard_size=args.max_shard_size,
+                                               safe_serialization=args.safe_serialization,
+                                               tag=args.tag,
+                                               exclude_frozen_parameters=args.exclude_frozen_parameters)