Instructions to use wangkanai/qwen3-vl-2b-instruct with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use wangkanai/qwen3-vl-2b-instruct with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="wangkanai/qwen3-vl-2b-instruct") 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 AutoModel model = AutoModel.from_pretrained("wangkanai/qwen3-vl-2b-instruct", dtype="auto") - llama-cpp-python
How to use wangkanai/qwen3-vl-2b-instruct with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="wangkanai/qwen3-vl-2b-instruct", filename="qwen3-vl-2b-instruct-abliterated-f16.gguf", )
llm.create_chat_completion( 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" } } ] } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use wangkanai/qwen3-vl-2b-instruct with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf wangkanai/qwen3-vl-2b-instruct:F16 # Run inference directly in the terminal: llama-cli -hf wangkanai/qwen3-vl-2b-instruct:F16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf wangkanai/qwen3-vl-2b-instruct:F16 # Run inference directly in the terminal: llama-cli -hf wangkanai/qwen3-vl-2b-instruct:F16
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf wangkanai/qwen3-vl-2b-instruct:F16 # Run inference directly in the terminal: ./llama-cli -hf wangkanai/qwen3-vl-2b-instruct:F16
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf wangkanai/qwen3-vl-2b-instruct:F16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf wangkanai/qwen3-vl-2b-instruct:F16
Use Docker
docker model run hf.co/wangkanai/qwen3-vl-2b-instruct:F16
- LM Studio
- Jan
- vLLM
How to use wangkanai/qwen3-vl-2b-instruct with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "wangkanai/qwen3-vl-2b-instruct" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "wangkanai/qwen3-vl-2b-instruct", "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/wangkanai/qwen3-vl-2b-instruct:F16
- SGLang
How to use wangkanai/qwen3-vl-2b-instruct 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 "wangkanai/qwen3-vl-2b-instruct" \ --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": "wangkanai/qwen3-vl-2b-instruct", "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 "wangkanai/qwen3-vl-2b-instruct" \ --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": "wangkanai/qwen3-vl-2b-instruct", "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" } } ] } ] }' - Ollama
How to use wangkanai/qwen3-vl-2b-instruct with Ollama:
ollama run hf.co/wangkanai/qwen3-vl-2b-instruct:F16
- Unsloth Studio
How to use wangkanai/qwen3-vl-2b-instruct with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for wangkanai/qwen3-vl-2b-instruct to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for wangkanai/qwen3-vl-2b-instruct to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for wangkanai/qwen3-vl-2b-instruct to start chatting
- Pi
How to use wangkanai/qwen3-vl-2b-instruct with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf wangkanai/qwen3-vl-2b-instruct:F16
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "wangkanai/qwen3-vl-2b-instruct:F16" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use wangkanai/qwen3-vl-2b-instruct with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf wangkanai/qwen3-vl-2b-instruct:F16
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default wangkanai/qwen3-vl-2b-instruct:F16
Run Hermes
hermes
- Atomic Chat new
- Docker Model Runner
How to use wangkanai/qwen3-vl-2b-instruct with Docker Model Runner:
docker model run hf.co/wangkanai/qwen3-vl-2b-instruct:F16
- Lemonade
How to use wangkanai/qwen3-vl-2b-instruct with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull wangkanai/qwen3-vl-2b-instruct:F16
Run and chat with the model
lemonade run user.qwen3-vl-2b-instruct-F16
List all available models
lemonade list
Qwen3-VL-2B-Instruct (Abliterated)
Qwen3-VL-2B-Instruct is a vision-language multimodal model capable of understanding both images and text inputs. This abliterated version has had safety guardrails removed for research and unconstrained creative applications.
Model Description
Qwen3-VL-2B-Instruct-Abliterated is a modified version of Alibaba's Qwen3-VL vision-language model with 2 billion parameters. The model combines:
- Vision Understanding: Advanced image comprehension and analysis
- Text Generation: High-quality natural language responses
- Multimodal Reasoning: Ability to reason about visual and textual information together
- Instruction Following: Fine-tuned to follow user instructions accurately
- Uncensored Output: Abliteration process removes refusal training for research applications
This model can perform tasks such as:
- Image captioning and detailed description
- Visual question answering (VQA)
- OCR (Optical Character Recognition)
- Document understanding and analysis
- Scene understanding and reasoning
- Creative visual storytelling
Repository Contents
qwen3-vl-2b-instruct/
├── qwen3-vl-2b-instruct-abliterated-f16.gguf (3.3 GB)
└── qwen3-vl-2b-instruct-abliterated.safetensors (4.0 GB)
Total Repository Size: ~7.3 GB
File Descriptions
- qwen3-vl-2b-instruct-abliterated-f16.gguf - FP16 quantized GGUF format for efficient inference with llama.cpp and compatible frameworks
- qwen3-vl-2b-instruct-abliterated.safetensors - Full-precision SafeTensors format for use with transformers library
Hardware Requirements
Minimum Requirements
- VRAM: 4-6 GB (GGUF quantized format)
- RAM: 8 GB system memory
- Disk Space: 8 GB free space
- GPU: CUDA-compatible GPU recommended
Recommended Requirements
- VRAM: 8 GB+ (SafeTensors full precision)
- RAM: 16 GB system memory
- Disk Space: 10 GB free space
- GPU: NVIDIA RTX 3060 or better
Usage Examples
Using SafeTensors with Transformers
from transformers import AutoModelForCausalLM, AutoTokenizer
from PIL import Image
# Load model and tokenizer
model_path = r"E:\huggingface\qwen3-vl-2b-instruct"
model = AutoModelForCausalLM.from_pretrained(
model_path,
torch_dtype="auto",
device_map="auto",
trust_remote_code=True
)
tokenizer = AutoTokenizer.from_pretrained(
model_path,
trust_remote_code=True
)
# Load image
image = Image.open("example.jpg")
# Create prompt
prompt = "Describe this image in detail."
# Generate response
inputs = tokenizer(prompt, images=image, return_tensors="pt").to(model.device)
outputs = model.generate(**inputs, max_new_tokens=512)
response = tokenizer.decode(outputs[0], skip_special_tokens=True)
print(response)
Using GGUF with llama.cpp
# Run with llama.cpp
./llama.cpp \
--model "E:\huggingface\qwen3-vl-2b-instruct\qwen3-vl-2b-instruct-abliterated-f16.gguf" \
--image example.jpg \
--prompt "What do you see in this image?" \
--n-predict 256 \
--temp 0.7
Using with LM Studio or Text Generation WebUI
LM Studio:
- Load the GGUF model file
- Select vision-language mode
- Upload image and provide text prompt
Text Generation WebUI (oobabooga):
- Place SafeTensors file in
models/directory - Load model with
trust_remote_code=True - Use multimodal extension for image inputs
- Place SafeTensors file in
Python Vision-Language Example
from transformers import Qwen2VLForConditionalGeneration, AutoProcessor
from PIL import Image
import torch
# Load model
model_path = r"E:\huggingface\qwen3-vl-2b-instruct"
processor = AutoProcessor.from_pretrained(model_path, trust_remote_code=True)
model = Qwen2VLForConditionalGeneration.from_pretrained(
model_path,
torch_dtype=torch.float16,
device_map="auto",
trust_remote_code=True
)
# Prepare inputs
image = Image.open("scene.jpg")
conversation = [
{
"role": "user",
"content": [
{"type": "image"},
{"type": "text", "text": "What is happening in this scene?"}
]
}
]
# Process and generate
text_prompt = processor.apply_chat_template(conversation, add_generation_prompt=True)
inputs = processor(text=[text_prompt], images=[image], return_tensors="pt")
inputs = inputs.to(model.device)
# Generate response
output_ids = model.generate(**inputs, max_new_tokens=512)
generated_text = processor.batch_decode(
output_ids,
skip_special_tokens=True,
clean_up_tokenization_spaces=True
)[0]
print(generated_text)
Model Specifications
| Specification | Details |
|---|---|
| Model Type | Vision-Language Model (VLM) |
| Architecture | Qwen3-VL (Transformer-based) |
| Parameters | 2 billion (2B) |
| Precision | FP16/FP32 (SafeTensors), Quantized (GGUF) |
| Context Length | 4096 tokens |
| Vision Encoder | Built-in vision transformer |
| Training Data | Multimodal image-text datasets |
| Modification | Abliterated (safety filters removed) |
| Formats | SafeTensors, GGUF |
Supported Image Formats
- JPEG, PNG, BMP, TIFF
- Recommended resolution: 224x224 to 1024x1024
- Automatic resizing and preprocessing
Performance Tips
Optimization Recommendations
Use Quantized GGUF for Speed:
- GGUF format provides faster inference
- Lower memory usage (3.3 GB vs 4.0 GB)
- Minimal quality loss for most tasks
GPU Acceleration:
- Enable CUDA for 3-5x speedup
- Use
device_map="auto"for automatic GPU utilization - Consider FP16 precision:
torch_dtype=torch.float16
Batch Processing:
- Process multiple images in batches for efficiency
- Use appropriate batch sizes based on VRAM
Image Preprocessing:
- Resize large images before processing
- Use JPEG format for faster loading
- Normalize images using processor's built-in methods
Memory Management:
- Clear CUDA cache between large operations
- Use gradient checkpointing if fine-tuning
- Monitor VRAM usage with
torch.cuda.memory_summary()
Expected Performance
- Inference Speed: 20-50 tokens/second (GPU)
- Image Processing: 0.5-2 seconds per image
- Memory Usage: 4-8 GB VRAM depending on format
Abliteration Process
What is Abliteration?
Abliteration is a technique that removes safety refusal mechanisms from language models while preserving their core capabilities. This version has been modified to:
- Remove content policy restrictions
- Eliminate refusal responses
- Enable uncensored creative outputs
- Maintain model quality and coherence
Use Cases:
- Research on model behavior and safety mechanisms
- Creative writing and storytelling without constraints
- Academic studies on model alignment
- Personal experimentation and learning
Responsible Use: This uncensored model should be used responsibly and ethically. Users are accountable for ensuring their applications comply with applicable laws and ethical guidelines.
License
This model is released under the Apache 2.0 License.
License Terms
- ✅ Commercial use allowed
- ✅ Modification and distribution permitted
- ✅ Private use allowed
- ⚠️ Must include license and copyright notice
- ⚠️ No warranty provided
Base Model License: The original Qwen3-VL model is licensed under Apache 2.0 by Alibaba Cloud.
Modification Notice: This abliterated version is a derivative work with safety mechanisms removed. Use responsibly and in accordance with applicable laws.
Citation
If you use this model in your research or applications, please cite:
@misc{qwen3vl2b-abliterated,
title={Qwen3-VL-2B-Instruct-Abliterated},
author={Abliteration Community},
year={2024},
howpublished={\url{https://huggingface.co/qwen3-vl-2b-instruct-abliterated}},
note={Abliterated version of Qwen3-VL-2B-Instruct}
}
@article{qwen3vl,
title={Qwen3-VL: Vision-Language Models at Scale},
author={Alibaba Cloud},
journal={arXiv preprint},
year={2024}
}
Links and Resources
Official Resources
- Qwen Official Repository: https://github.com/QwenLM/Qwen3-VL
- Hugging Face Model Hub: https://huggingface.co/Qwen
- Documentation: https://qwen.readthedocs.io/
- Qwen Technical Report: https://arxiv.org/abs/qwen3vl
Community Resources
- Abliteration Research: Studies on safety mechanism removal techniques
- llama.cpp: https://github.com/ggerganov/llama.cpp (for GGUF inference)
- Text Generation WebUI: https://github.com/oobabooga/text-generation-webui
- LM Studio: https://lmstudio.ai/
Support and Discussion
- Issues: Report problems with the model
- Discussions: Share use cases and improvements
- Pull Requests: Contribute documentation updates
Disclaimer
This abliterated model has had safety mechanisms removed and may generate content without restrictions. Users are solely responsible for:
- Ensuring legal compliance in their jurisdiction
- Following ethical guidelines for AI usage
- Not using the model for harmful or illegal purposes
- Understanding the implications of uncensored AI outputs
No Warranty: This model is provided "as-is" without any guarantees of accuracy, safety, or fitness for any particular purpose.
Model Version: v1.1 Last Updated: 2025-10-30 Format Versions: SafeTensors (4.0 GB), GGUF FP16 (3.3 GB)
- Downloads last month
- 25
16-bit