Instructions to use Hon-Wong/VoRA-7B-Base with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Hon-Wong/VoRA-7B-Base with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="Hon-Wong/VoRA-7B-Base", trust_remote_code=True) messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("Hon-Wong/VoRA-7B-Base", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use Hon-Wong/VoRA-7B-Base with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Hon-Wong/VoRA-7B-Base" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Hon-Wong/VoRA-7B-Base", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/Hon-Wong/VoRA-7B-Base
- SGLang
How to use Hon-Wong/VoRA-7B-Base with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "Hon-Wong/VoRA-7B-Base" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Hon-Wong/VoRA-7B-Base", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "Hon-Wong/VoRA-7B-Base" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Hon-Wong/VoRA-7B-Base", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Docker Model Runner
How to use Hon-Wong/VoRA-7B-Base with Docker Model Runner:
docker model run hf.co/Hon-Wong/VoRA-7B-Base
| import os.path as osp | |
| import torch | |
| import torch.distributed as dist | |
| from transformers import ( | |
| AutoModelForCausalLM, | |
| AutoTokenizer, | |
| AutoConfig, | |
| PreTrainedModel, | |
| PretrainedConfig, | |
| Qwen2ForCausalLM, | |
| ) | |
| from .attention_mask import make_mask | |
| from .configuration_vora import VoRAConfig | |
| from .lora import apply_lora | |
| from .vision_embedding import build_vision_embedding | |
| from .vora_generation_utils import ( | |
| VoraGenerationMixin, | |
| custom_prepare_4d_causal_attention_mask_with_cache_position, | |
| ) | |
| class VoRAForCausalLM(PreTrainedModel): | |
| config_class = VoRAConfig | |
| _auto_class = 'AutoModelForCausalLM' | |
| supports_gradient_checkpointing = True | |
| def __init__(self, config: PretrainedConfig = VoRAConfig()): | |
| super().__init__(config) | |
| self.config = config | |
| # -------------- Setup LLM --------------------- | |
| self.llm = Qwen2ForCausalLM(config) | |
| # monkey patch for generation | |
| 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) | |
| dtype = self.llm.dtype | |
| # hacking for multi-processor infer | |
| self._tp_plan = self.llm._tp_plan | |
| 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) | |
| self.llm.to(dtype) | |
| # ---------------------------------------------- | |
| # ------------ Setup Vision Embedding ---------- | |
| self.vision_embedding = build_vision_embedding(config, self.llm.config.hidden_size) | |
| # ---------------------------------------------- | |
| 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, pad_token_id=0): | |
| """ concat vision and text | |
| """ | |
| vision_embeds, vision_atts, vision_targets, _ = vision_encode_out | |
| input_embeds = [] | |
| attention_mask = [] | |
| targets = [] | |
| vision_mask = [] # only set vision embeds as 1, text as 0, for aux loss | |
| 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]: | |
| pad_token = torch.tensor([pad_token_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 generate(self, batch, **generate_params): | |
| with torch.amp.autocast( | |
| device_type="cuda", | |
| enabled=(self.device != torch.device("cpu")) | |
| ): | |
| # 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, pad_token_id=generate_params["eos_token_id"]) | |
| outputs = self.llm.generate( | |
| inputs_embeds=inputs_embeds, | |
| attention_mask=attention_mask, | |
| output_attentions=True, | |
| **generate_params | |
| ) | |
| return outputs | |