Instructions to use jadechoghari/Ferret-UI-Llama8b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use jadechoghari/Ferret-UI-Llama8b with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="jadechoghari/Ferret-UI-Llama8b", 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("jadechoghari/Ferret-UI-Llama8b", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use jadechoghari/Ferret-UI-Llama8b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "jadechoghari/Ferret-UI-Llama8b" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "jadechoghari/Ferret-UI-Llama8b", "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/jadechoghari/Ferret-UI-Llama8b
- SGLang
How to use jadechoghari/Ferret-UI-Llama8b 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 "jadechoghari/Ferret-UI-Llama8b" \ --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": "jadechoghari/Ferret-UI-Llama8b", "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 "jadechoghari/Ferret-UI-Llama8b" \ --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": "jadechoghari/Ferret-UI-Llama8b", "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 jadechoghari/Ferret-UI-Llama8b with Docker Model Runner:
docker model run hf.co/jadechoghari/Ferret-UI-Llama8b
| import torch | |
| import torch.nn as nn | |
| from transformers import CLIPVisionModel, CLIPImageProcessor, CLIPVisionConfig | |
| # Added for customized Processor. | |
| import math | |
| import numpy as np | |
| from typing import Dict | |
| from transformers.image_utils import PILImageResampling, ChannelDimension | |
| from transformers.image_processing_utils import get_size_dict | |
| from transformers.image_transforms import ( | |
| get_resize_output_image_size, | |
| resize, | |
| ) | |
| from typing import List, Optional, Tuple, Union | |
| class CLIPImageProcessor_Ferret(CLIPImageProcessor): | |
| def resize( | |
| self, | |
| image: np.ndarray, | |
| size: Dict[str, int], | |
| resample: PILImageResampling = PILImageResampling.BICUBIC, | |
| data_format: Optional[Union[str, ChannelDimension]] = None, | |
| **kwargs, | |
| ) -> np.ndarray: | |
| """ | |
| Resize an image. The shortest edge of the image is resized to size["shortest_edge"], with the longest edge | |
| resized to keep the input aspect ratio. | |
| Args: | |
| image (`np.ndarray`): | |
| Image to resize. | |
| size (`Dict[str, int]`): | |
| Size of the output image. | |
| resample (`PILImageResampling`, *optional*, defaults to `PILImageResampling.BICUBIC`): | |
| Resampling filter to use when resiizing the image. | |
| data_format (`str` or `ChannelDimension`, *optional*): | |
| The channel dimension format of the image. If not provided, it will be the same as the input image. | |
| """ | |
| size = get_size_dict(size, default_to_square=True, height_width_order=True) | |
| # Hack: Bypass the shortest_edge detection. We hope to get a {"height": size[0], "width": size[1]}, where w=h. | |
| # if "shortest_edge" not in size: | |
| # raise ValueError(f"The `size` parameter must contain the key `shortest_edge`. Got {size.keys()}") | |
| # output_size = get_resize_output_image_size(image, size=size["shortest_edge"], default_to_square=True) | |
| output_size = get_resize_output_image_size(image, size=(size["height"], size["width"]), default_to_square=True) | |
| return resize(image, size=output_size, resample=resample, data_format=data_format, **kwargs) | |
| class CLIPVisionTower(nn.Module): | |
| def __init__(self, vision_tower, args, delay_load=False): | |
| super().__init__() | |
| self.is_loaded = False | |
| self.preprocess_type = getattr(args, 'version', 'ferret_v1') | |
| self.vision_tower_name = vision_tower | |
| self.select_layer = args.mm_vision_select_layer | |
| self.select_feature = getattr(args, 'mm_vision_select_feature', 'patch') | |
| if not delay_load: | |
| self.load_model() | |
| elif getattr(args, 'unfreeze_mm_vision_tower', False): | |
| self.load_model() | |
| else: | |
| self.cfg_only = CLIPVisionConfig.from_pretrained(self.vision_tower_name) | |
| def load_model(self, device_map=None): | |
| if self.is_loaded: | |
| print('{} is already loaded, `load_model` called again, skipping.'.format(self.vision_tower_name)) | |
| return | |
| if "ferret" in self.preprocess_type: | |
| self.image_processor = CLIPImageProcessor_Ferret.from_pretrained(self.vision_tower_name) | |
| else: | |
| self.image_processor = CLIPImageProcessor.from_pretrained(self.vision_tower_name) | |
| self.vision_tower = CLIPVisionModel.from_pretrained(self.vision_tower_name, device_map=device_map) | |
| self.vision_tower.requires_grad_(False) | |
| self.is_loaded = True | |
| def feature_select(self, image_forward_outs): | |
| image_features = image_forward_outs.hidden_states[self.select_layer] | |
| if self.select_feature == 'patch': | |
| image_features = image_features[:, 1:] | |
| elif self.select_feature == 'cls_patch': | |
| image_features = image_features | |
| else: | |
| raise ValueError(f'Unexpected select feature: {self.select_feature}') | |
| return image_features | |
| # @torch.no_grad() | |
| def forward(self, images): | |
| if type(images) is list: | |
| image_features = [] | |
| for image in images: | |
| image_forward_out = self.vision_tower(image.to(device=self.device, dtype=self.dtype).unsqueeze(0), output_hidden_states=True) | |
| image_feature = self.feature_select(image_forward_out).to(image.dtype) | |
| image_features.append(image_feature) | |
| else: | |
| image_forward_outs = self.vision_tower(images.to(device=self.device, dtype=self.dtype), output_hidden_states=True) | |
| image_features = self.feature_select(image_forward_outs).to(images.dtype) | |
| return image_features | |
| def dummy_feature(self): | |
| return torch.zeros(1, self.hidden_size, device=self.device, dtype=self.dtype) | |
| def dtype(self): | |
| return self.vision_tower.dtype | |
| def device(self): | |
| return self.vision_tower.device | |
| def config(self): | |
| if self.is_loaded: | |
| return self.vision_tower.config | |
| else: | |
| return self.cfg_only | |
| def hidden_size(self): | |
| return self.config.hidden_size | |
| def num_patches_per_side(self): | |
| return self.config.image_size // self.config.patch_size | |
| def num_patches(self): | |
| return (self.config.image_size // self.config.patch_size) ** 2 | |
| class CLIPVisionTowerS2(CLIPVisionTower): | |
| def __init__(self, vision_tower, args, delay_load=False): | |
| super().__init__(vision_tower, args, delay_load) | |
| self.s2_scales = getattr(args, 's2_scales', '336,672,1008') | |
| self.s2_scales = list(map(int, self.s2_scales.split(','))) | |
| self.s2_scales.sort() | |
| self.s2_split_size = self.s2_scales[0] | |
| self.s2_image_size = self.s2_scales[-1] | |
| try: | |
| from s2wrapper import forward as multiscale_forward | |
| except ImportError: | |
| raise ImportError('Package s2wrapper not found! Please install by running: \npip install git+https://github.com/bfshi/scaling_on_scales.git') | |
| self.multiscale_forward = multiscale_forward | |
| # change resize/crop size in preprocessing to the largest image size in s2_scale | |
| if not delay_load or getattr(args, 'unfreeze_mm_vision_tower', False): | |
| self.image_processor.size['shortest_edge'] = self.s2_image_size | |
| self.image_processor.crop_size['height'] = self.image_processor.crop_size['width'] = self.s2_image_size | |
| def load_model(self, device_map=None): | |
| if self.is_loaded: | |
| print('{} is already loaded, `load_model` called again, skipping.'.format(self.vision_tower_name)) | |
| return | |
| self.image_processor = CLIPImageProcessor.from_pretrained(self.vision_tower_name) | |
| self.vision_tower = CLIPVisionModel.from_pretrained(self.vision_tower_name, device_map=device_map) | |
| self.vision_tower.requires_grad_(False) | |
| self.image_processor.size['shortest_edge'] = self.s2_image_size | |
| self.image_processor.crop_size['height'] = self.image_processor.crop_size['width'] = self.s2_image_size | |
| self.is_loaded = True | |
| def forward_feature(self, images): | |
| image_forward_outs = self.vision_tower(images.to(device=self.device, dtype=self.dtype), output_hidden_states=True) | |
| image_features = self.feature_select(image_forward_outs).to(images.dtype) | |
| return image_features | |
| def forward(self, images): | |
| if type(images) is list: | |
| image_features = [] | |
| for image in images: | |
| image_feature = self.multiscale_forward(self.forward_feature, image.unsqueeze(0), img_sizes=self.s2_scales, max_split_size=self.s2_split_size) | |
| image_features.append(image_feature) | |
| else: | |
| image_features = self.multiscale_forward(self.forward_feature, images, img_sizes=self.s2_scales, max_split_size=self.s2_split_size) | |
| return image_features | |
| def hidden_size(self): | |
| return self.config.hidden_size * len(self.s2_scales) |