Instructions to use filvyb/ZwZ-8B-heretic-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use filvyb/ZwZ-8B-heretic-GGUF with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="filvyb/ZwZ-8B-heretic-GGUF") 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("filvyb/ZwZ-8B-heretic-GGUF", dtype="auto") - llama-cpp-python
How to use filvyb/ZwZ-8B-heretic-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="filvyb/ZwZ-8B-heretic-GGUF", filename="ZwZ-8B-heretic-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
- llama.cpp
How to use filvyb/ZwZ-8B-heretic-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
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 filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
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 filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
Use Docker
docker model run hf.co/filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use filvyb/ZwZ-8B-heretic-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "filvyb/ZwZ-8B-heretic-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "filvyb/ZwZ-8B-heretic-GGUF", "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/filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
- SGLang
How to use filvyb/ZwZ-8B-heretic-GGUF 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 "filvyb/ZwZ-8B-heretic-GGUF" \ --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": "filvyb/ZwZ-8B-heretic-GGUF", "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 "filvyb/ZwZ-8B-heretic-GGUF" \ --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": "filvyb/ZwZ-8B-heretic-GGUF", "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 filvyb/ZwZ-8B-heretic-GGUF with Ollama:
ollama run hf.co/filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
- Unsloth Studio new
How to use filvyb/ZwZ-8B-heretic-GGUF 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 filvyb/ZwZ-8B-heretic-GGUF 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 filvyb/ZwZ-8B-heretic-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for filvyb/ZwZ-8B-heretic-GGUF to start chatting
- Pi new
How to use filvyb/ZwZ-8B-heretic-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
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": "filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use filvyb/ZwZ-8B-heretic-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
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 filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
Run Hermes
hermes
- Docker Model Runner
How to use filvyb/ZwZ-8B-heretic-GGUF with Docker Model Runner:
docker model run hf.co/filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
- Lemonade
How to use filvyb/ZwZ-8B-heretic-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull filvyb/ZwZ-8B-heretic-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.ZwZ-8B-heretic-GGUF-Q4_K_M
List all available models
lemonade list
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 filvyb/ZwZ-8B-heretic-GGUF:Run Hermes
hermesThis is a quantized decensored version of inclusionAI/ZwZ-8B, made using Heretic v1.2.0
Abliteration parameters
| Parameter | Value |
|---|---|
| direction_index | 20.97 |
| attn.o_proj.max_weight | 1.35 |
| attn.o_proj.max_weight_position | 28.23 |
| attn.o_proj.min_weight | 1.27 |
| attn.o_proj.min_weight_distance | 20.10 |
| mlp.down_proj.max_weight | 1.47 |
| mlp.down_proj.max_weight_position | 21.98 |
| mlp.down_proj.min_weight | 0.05 |
| mlp.down_proj.min_weight_distance | 15.28 |
Performance
| Metric | This model | Original model (inclusionAI/ZwZ-8B) |
|---|---|---|
| KL divergence | 0.0669 | 0 (by definition) |
| Refusals | 4/100 | 99/100 |
ZwZ-8B
📃 Paper | 🏠 Project | 🤗 Collection
Model Summary
ZwZ-8B is a fine-grained multimodal perception model built upon Qwen3-VL-8B. It is trained using Region-to-Image Distillation (R2I) combined with reinforcement learning, enabling superior fine-grained visual understanding in a single forward pass — no inference-time zooming or tool calling required.
ZwZ-8B achieves state-of-the-art performance on fine-grained perception benchmarks among open-source models of comparable size, while also demonstrating strong out-of-distribution generalization on visual reasoning, GUI agent, and AIGC detection tasks.
Key Features
- ⚡ Single-Pass Efficiency: Achieves fine-grained perception in one forward pass, eliminating inference-time tool-calling overhead
- 🎯 Superior Accuracy: State-of-the-art on perception benchmarks among open-source models
- 📈 Broad Improvements: Enhances not only perception benchmarks but also out-of-distribution generalization on visual reasoning, GUI agent, and AIGC detection
How It Works
Traditional "Thinking-with-Images" methods zoom into regions of interest during inference, incurring high latency from repeated tool calls and visual re-encoding. ZwZ transforms zooming from an inference-time tool into a training-time primitive:
- Zoom in to micro-cropped regions and let strong teacher models (Qwen3-VL-235B, GLM-4.5V) generate high-quality VQA data
- Distill this region-grounded supervision back to the full image with explicit bounding-box overlays
- Reinforce via RL training to enable single-glance fine-grained perception without tool use
Quickstart
Installation
pip install transformers accelerate torch
Inference
from transformers import Qwen3VLForConditionalGeneration, AutoProcessor
# default: Load the model on the available device(s)
model = Qwen3VLForConditionalGeneration.from_pretrained(
"inclusionAI/ZwZ-8B", dtype="auto", device_map="auto"
)
processor = AutoProcessor.from_pretrained("inclusionAI/ZwZ-8B")
messages = [
{
"role": "user",
"content": [
{
"type": "image",
"image": "https://qianwen-res.oss-cn-beijing.aliyuncs.com/Qwen-VL/assets/demo.jpeg",
},
{"type": "text", "text": "Describe this image."},
],
}
]
# Preparation for inference
inputs = processor.apply_chat_template(
messages,
tokenize=True,
add_generation_prompt=True,
return_dict=True,
return_tensors="pt"
)
inputs = inputs.to(model.device)
# Inference: Generation of the output
generated_ids = model.generate(**inputs, max_new_tokens=128)
generated_ids_trimmed = [
out_ids[len(in_ids) :] for in_ids, out_ids in zip(inputs.input_ids, generated_ids)
]
output_text = processor.batch_decode(
generated_ids_trimmed, skip_special_tokens=True, clean_up_tokenization_spaces=False
)
print(output_text)
Training Data
ZwZ-8B is trained on inclusionAI/ZwZ-RL-VQA, a 74K-sample Region-to-Image distilled VQA dataset synthesized from diverse image pools (SA-1B, LAION, MetaCLIP, Visual Genome, CC12M, STPLS3D).
Citation
@article{wei2026zooming,
title={Zooming without Zooming: Region-to-Image Distillation for Fine-Grained Multimodal Perception},
author={Wei, Lai and He, Liangbo and Lan, Jun and Dong, Lingzhong and Cai, Yutong and Li, Siyuan and Zhu, Huijia and Wang, Weiqiang and Kong, Linghe and Wang, Yue and Zhang, Zhuosheng and Huang, Weiran},
journal={arXiv preprint arXiv:2602.11858},
year={2026}
}
License
This model follows the license of Apache 2.0 License.
- Downloads last month
- 38
2-bit
3-bit
4-bit
5-bit
6-bit
8-bit
16-bit
Model tree for filvyb/ZwZ-8B-heretic-GGUF
Base model
Qwen/Qwen3-VL-8B-Instruct
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp# Start a local OpenAI-compatible server: llama-server -hf filvyb/ZwZ-8B-heretic-GGUF: