Image-Text-to-Text
Transformers
Safetensors
English
granite4_vision
conversational
custom_code
8-bit precision
Instructions to use beaupi/granite-vision-4.1-4b-oQ8 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use beaupi/granite-vision-4.1-4b-oQ8 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="beaupi/granite-vision-4.1-4b-oQ8", 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 AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("beaupi/granite-vision-4.1-4b-oQ8", trust_remote_code=True) model = AutoModelForMultimodalLM.from_pretrained("beaupi/granite-vision-4.1-4b-oQ8", trust_remote_code=True, device_map="auto") 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?"} ] }, ] inputs = processor.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use beaupi/granite-vision-4.1-4b-oQ8 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "beaupi/granite-vision-4.1-4b-oQ8" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "beaupi/granite-vision-4.1-4b-oQ8", "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/beaupi/granite-vision-4.1-4b-oQ8
- SGLang
How to use beaupi/granite-vision-4.1-4b-oQ8 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 "beaupi/granite-vision-4.1-4b-oQ8" \ --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": "beaupi/granite-vision-4.1-4b-oQ8", "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 "beaupi/granite-vision-4.1-4b-oQ8" \ --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": "beaupi/granite-vision-4.1-4b-oQ8", "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 beaupi/granite-vision-4.1-4b-oQ8 with Docker Model Runner:
docker model run hf.co/beaupi/granite-vision-4.1-4b-oQ8
| {#- ===== Task tag prompt constants ===== -#} | |
| {%- set chart2code_prompt = "Generate code that recreates the chart as best as possible." -%} | |
| {%- set chart2csv_prompt = "Please examine this chart image. Consider you are a data visualization expert, and extract the data into a CSV table.\n\nYour CSV should:\n- Include a header row with clear column names\n- Represent all data series/categories shown in the chart\n- Use numeric values that match the chart as closely as possible\n\nOutput only the CSV data, nothing else." -%} | |
| {%- set chart2summary_prompt = "Can you describe this chart image?" -%} | |
| {%- set tables_json_prompt = "Identify and extract the table schema\n Extract the schema of all the tables in the image sorted according to the reading order.\nThe output must be a valid JSON object containing a list of dictionaries with the following structure:\n\n {\n \"dimensions\": {\n \"rows\": <number of data rows (excluding header rows)>,\n \"columns\": <number of columns>,\n \"header_rows\": <number of header rows>,\n \"total_rows\": <total number of rows including headers>\n },\n \"cells\": [\n {\n \"row\": <row index starting at 1>,\n \"col\": <column index starting at 1>,\n \"colspan\": <number of columns spanned>,\n \"rowspan\": <number of rows spanned>,\n \"type\": \"<'header' or 'data'>\",\n \"header_level\": <header nesting level if type=header, else omit or null>,\n \"content\": \"<string content of the cell>\"\n },\n ...\n ]\n }" -%} | |
| {%- set tables_html_prompt = "Identify and extract the table schema\n Extract the schema of all the tables in the image sorted according to the reading order.\nThe output must be a list of valid HTML tables" -%} | |
| {%- set tables_otsl_prompt = "Identify and extract the table schema\n Extract the schema of all the tables in the image sorted according to the reading order.\nThe output must be a list of valid OTSL objects, each consists of the following fields: \n <fcel> - a cell with content in it\n <ecel> - an empty cell\n <lcel> - a cell that is merged with the cell to its left\n <ucel> - a cell that is merged with the cell above it\n <xcel> - a cell that is merged with both the cell above it and the cell to its left\n <nl> - a new line\n <ched> - a column header\n <otsl> - the beginning of the OTSL table\n </otsl> - the end of the OTSL table\n\n An example for an output:\n [\n <otsl><ched>first table header1<ched>first table header2<nl><fcel>data1<fcel>data2<nl><fcel>data with horizontal span<lcel><nl><fcel>data with vertical span<ecel><nl><ucel><fcel>data3<nl></otsl>,\n <otsl><ched>second table header1<ched>second table header2<nl><fcel>data1<fcel>data2<nl><fcel>data with horizontal span<lcel><nl><fcel>data with vertical span<ecel><nl><ucel><fcel>data3<nl></otsl>\n ]" -%} | |
| {#- ===== Tag expansion dispatcher ===== -#} | |
| {%- macro expand_tags(text) -%} | |
| {%- set has_image = "<image>" in text -%} | |
| {#- Determine image position: prefix if <image> appears before the tag, suffix if after -#} | |
| {%- if has_image -%} | |
| {%- set img_idx = text.index("<image>") -%} | |
| {%- if "<chart2code>" in text -%}{%- set tag_idx = text.index("<chart2code>") -%} | |
| {%- elif "<chart2csv>" in text -%}{%- set tag_idx = text.index("<chart2csv>") -%} | |
| {%- elif "<chart2summary>" in text -%}{%- set tag_idx = text.index("<chart2summary>") -%} | |
| {%- elif "<tables_json>" in text -%}{%- set tag_idx = text.index("<tables_json>") -%} | |
| {%- elif "<tables_html>" in text -%}{%- set tag_idx = text.index("<tables_html>") -%} | |
| {%- elif "<tables_otsl>" in text -%}{%- set tag_idx = text.index("<tables_otsl>") -%} | |
| {%- else -%}{%- set tag_idx = 999999 -%} | |
| {%- endif -%} | |
| {%- set img_prefix = "<image>\n" if img_idx < tag_idx else "" -%} | |
| {%- set img_suffix = "<image>\n" if img_idx >= tag_idx else "" -%} | |
| {%- else -%} | |
| {%- set img_prefix = "" -%} | |
| {%- set img_suffix = "" -%} | |
| {%- endif -%} | |
| {%- if "<chart2code>" in text -%} | |
| {{- img_prefix + chart2code_prompt + img_suffix -}} | |
| {%- elif "<chart2csv>" in text -%} | |
| {{- img_prefix + chart2csv_prompt + img_suffix -}} | |
| {%- elif "<chart2summary>" in text -%} | |
| {{- img_prefix + chart2summary_prompt + img_suffix -}} | |
| {%- elif "<tables_json>" in text -%} | |
| {{- img_prefix + tables_json_prompt + img_suffix -}} | |
| {%- elif "<tables_html>" in text -%} | |
| {{- img_prefix + tables_html_prompt + img_suffix -}} | |
| {%- elif "<tables_otsl>" in text -%} | |
| {{- img_prefix + tables_otsl_prompt + img_suffix -}} | |
| {%- else -%} | |
| {{- text -}} | |
| {%- endif -%} | |
| {%- endmacro -%} | |
| {#- ===== Original chat template ===== -#} | |
| {% macro render_content(x) %} | |
| {%- if x is string %} | |
| {{ x }} | |
| {%- else %} | |
| {%- for chunk in x %} | |
| {%- if chunk['type'] == 'text' -%} | |
| {{ chunk['text']}} | |
| {%- elif chunk['type'] == 'image' -%} | |
| {{- "<image> | |
| " }} | |
| {%- endif -%} | |
| {%- endfor -%} | |
| {%- endif -%} | |
| {% endmacro %} | |
| {%- set tools_system_message_prefix = 'You are a helpful assistant with access to the following tools. You may call one or more tools to assist with the user query.\n\nYou are provided with function signatures within <tools></tools> XML tags:\n<tools>' %} | |
| {%- set tools_system_message_suffix = '\n</tools>\n\nFor each tool 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>. If a tool does not exist in the provided list of tools, notify the user that you do not have the ability to fulfill the request.' %} | |
| {%- set documents_system_message_prefix = 'You are a helpful assistant with access to the following documents. You may use one or more documents to assist with the user query.\n\nYou are given a list of documents within <documents></documents> XML tags:\n<documents>' %} | |
| {%- set documents_system_message_suffix = '\n</documents>\n\nWrite the response to the user\'s input by strictly aligning with the facts in the provided documents. If the information needed to answer the question is not available in the documents, inform the user that the question cannot be answered based on the available data.' %} | |
| {%- set g4_default_system_message = 'You are a helpful assistant. Please ensure responses are professional, accurate, and safe.' %} | |
| {%- if available_tools is defined and available_tools %} | |
| {%- set tools = available_tools %} | |
| {%- endif %} | |
| {%- set ns = namespace(tools_system_message=tools_system_message_prefix, | |
| documents_system_message=documents_system_message_prefix, | |
| default_system_message=g4_default_system_message, | |
| system_message='' | |
| ) %} | |
| {%- if tools %} | |
| {%- for tool in tools %} | |
| {%- set ns.tools_system_message = ns.tools_system_message + '\n' + (tool | tojson) %} | |
| {%- endfor %} | |
| {%- set ns.tools_system_message = ns.tools_system_message + tools_system_message_suffix %} | |
| {%- else %} | |
| {%- set ns.tools_system_message = '' %} | |
| {%- endif %} | |
| {%- if documents %} | |
| {%- for document in documents %} | |
| {%- set ns.documents_system_message = ns.documents_system_message + '\n' + (document | tojson) %} | |
| {%- endfor %} | |
| {%- set ns.documents_system_message = ns.documents_system_message + documents_system_message_suffix %} | |
| {%- else %} | |
| {%- set ns.documents_system_message = '' %} | |
| {%- endif %} | |
| {%- if messages[0].role == 'system' %} | |
| {%- if messages[0].content is string %} | |
| {%- set ns.system_message = messages[0].content %} | |
| {%- elif messages[0].content is iterable %} | |
| {%- for entry in messages[0].content %} | |
| {%- if entry.type== 'text' %} | |
| {%- if ns.system_message != '' %} | |
| {%- set ns.system_message = ns.system_message + '\n' %} | |
| {%- endif %} | |
| {%- set ns.system_message = ns.system_message + entry.text %} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- endif %} | |
| {%- if tools and documents %} | |
| {%- set ns.system_message = ns.system_message + '\n\n' + ns.tools_system_message + '\n\n' + ns.documents_system_message %} | |
| {%- elif tools %} | |
| {%- set ns.system_message = ns.system_message + '\n\n' + ns.tools_system_message %} | |
| {%- elif documents %} | |
| {%- set ns.system_message = ns.system_message + '\n\n' + ns.documents_system_message %} | |
| {%- endif %} | |
| {%- else %} | |
| {%- if tools and documents %} | |
| {%- set ns.system_message = ns.tools_system_message + '\n\n' + ns.documents_system_message %} | |
| {%- elif tools %} | |
| {%- set ns.system_message = ns.tools_system_message %} | |
| {%- elif documents %} | |
| {%- set ns.system_message = ns.documents_system_message %} | |
| {%- endif %} | |
| {%- endif %} | |
| {%- if ns.system_message %} | |
| {{- '<|start_of_role|>system<|end_of_role|>' + ns.system_message + '<|end_of_text|>\n' }} | |
| {%- else %} | |
| {{- '<|start_of_role|>system<|end_of_role|>' + ns.default_system_message + '<|end_of_text|>\n' }} | |
| {%- endif %} | |
| {%- for message in messages %} | |
| {%- set content = namespace(val='') %} | |
| {%- if render_content(message['content']) is string %} | |
| {%- set content.val = render_content(message['content']) %} | |
| {%- else %} | |
| {%- if render_content(message['content']) is iterable %} | |
| {%- for entry in render_content(message['content']) %} | |
| {%- if entry.type== 'text' %} | |
| {%- if content.val != '' %} | |
| {%- set content.val = content.val + '\n' %} | |
| {%- endif %} | |
| {%- set content.val = content.val + entry.text %} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- endif %} | |
| {%- endif %} | |
| {%- if (message.role == 'user') or (message.role == 'system' and not loop.first) %} | |
| {{- '<|start_of_role|>' + message.role + '<|end_of_role|>' + expand_tags(content.val) + '<|end_of_text|>\n' }} | |
| {%- elif message.role == 'assistant' %} | |
| {{- '<|start_of_role|>' + message.role + '<|end_of_role|>' + content.val }} | |
| {%- if message.tool_calls %} | |
| {%- for tool_call in message.tool_calls %} | |
| {%- if (loop.first and content.val) or (not loop.first) %} | |
| {{- '\n' }} | |
| {%- endif %} | |
| {%- if tool_call.function %} | |
| {%- set tool_call = tool_call.function %} | |
| {%- endif %} | |
| {{- '<tool_call>\n{"name": "' }} | |
| {{- tool_call.name }} | |
| {{- '", "arguments": ' }} | |
| {%- if tool_call.arguments is string %} | |
| {{- tool_call.arguments }} | |
| {%- else %} | |
| {{- tool_call.arguments | tojson }} | |
| {%- endif %} | |
| {{- '}\n</tool_call>' }} | |
| {%- endfor %} | |
| {%- endif %} | |
| {{- '<|end_of_text|>\n' }} | |
| {%- elif message.role == 'tool' %} | |
| {%- if loop.first or (messages[loop.index0 - 1].role != 'tool') %} | |
| {{- '<|start_of_role|>user<|end_of_role|>' }} | |
| {%- endif %} | |
| {{- '\n<tool_response>\n' }} | |
| {{- content.val }} | |
| {{- '\n</tool_response>' }} | |
| {%- if loop.last or (messages[loop.index0 + 1].role != 'tool') %} | |
| {{- '<|end_of_text|>\n' }} | |
| {%- endif %} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- if add_generation_prompt %} | |
| {{- '<|start_of_role|>assistant<|end_of_role|>' }} | |
| {%- endif %} |