Instructions to use prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX") 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("prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX") model = AutoModelForMultimodalLM.from_pretrained("prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX", 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 prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX", "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/prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX
- SGLang
How to use prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX 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 "prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX" \ --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": "prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX", "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 "prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX" \ --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": "prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX", "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 prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX with Docker Model Runner:
docker model run hf.co/prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX
Qwen2.5-VL-3B-Instruct-Unredacted-MAX
Qwen2.5-VL-3B-Instruct-Unredacted-MAX is an optimized release built on top of huihui-ai/Qwen2.5-VL-3B-Instruct-abliterated. This version focuses on improved model packaging, updated compatibility with modern Transformers pipelines, and stable multimodal inference behavior, while preserving the core vision-language reasoning capabilities of the original architecture. The result is a compact 3B vision-language model designed for efficient deployment, research experimentation, and multimodal application development.
Key Highlights
Optimized Release Packaging Streamlined repository structure for smoother loading, inference, and deployment workflows.
Modern Transformers Compatibility Updated to ensure stable integration with recent Hugging Face Transformers versions.
3B Vision-Language Architecture Built on Qwen2.5-VL-3B-Instruct, balancing multimodal capability with lightweight deployment requirements.
Stable Multimodal Inference Designed for consistent performance across image-text reasoning tasks.
Efficient Caption Generation Produces structured, descriptive outputs suitable for annotation and dataset building.
Dynamic Resolution Support Retains native handling of varying image resolutions and aspect ratios.
Base Model Signatures:
This model has been re-sharded and optimized for the latest Transformers version from the base model: https://huggingface.co/huihui-ai/Qwen2.5-VL-3B-Instruct-abliterated
Quick Start with Transformers
from transformers import Qwen2_5_VLForConditionalGeneration, AutoTokenizer, AutoProcessor
from qwen_vl_utils import process_vision_info
import torch
model = Qwen2_5_VLForConditionalGeneration.from_pretrained(
"prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX",
torch_dtype="auto",
device_map="auto"
)
processor = AutoProcessor.from_pretrained(
"prithivMLmods/Qwen2.5-VL-3B-Instruct-Unredacted-MAX"
)
messages = [
{
"role": "user",
"content": [
{
"type": "image",
"image": "https://qianwen-res.oss-cn-beijing.aliyuncs.com/Qwen-VL/assets/demo.jpeg",
},
{"type": "text", "text": "Provide a detailed caption for this image."},
],
}
]
text = processor.apply_chat_template(
messages, tokenize=False, add_generation_prompt=True
)
image_inputs, video_inputs = process_vision_info(messages)
inputs = processor(
text=[text],
images=image_inputs,
videos=video_inputs,
padding=True,
return_tensors="pt",
).to("cuda")
generated_ids = model.generate(**inputs, max_new_tokens=256)
output_text = processor.batch_decode(
[out[len(inp):] for inp, out in zip(inputs.input_ids, generated_ids)],
skip_special_tokens=True,
clean_up_tokenization_spaces=False
)
print(output_text)
Intended Use
- Multimodal AI research and evaluation
- Image captioning and dataset generation pipelines
- Vision-language prototyping and experimentation
- Lightweight deployment in constrained environments
- Development of multimodal applications and tools
Limitations & Risks
Important Note: This model inherits behavior and constraints from its base architecture.
- Performance depends on image quality, resolution, and prompt design
- May produce incomplete or inaccurate interpretations in complex scenes
- Requires adequate GPU resources for stable inference
- Output consistency varies with decoding settings and runtime optimization
- Downloads last month
- 20
