Instructions to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="FadedRedStar/Qwen3.5-9B-heretic-GGUF", filename="Qwen3.5-9B-heretic-Q4_K_M.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 FadedRedStar/Qwen3.5-9B-heretic-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf FadedRedStar/Qwen3.5-9B-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 FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf FadedRedStar/Qwen3.5-9B-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 FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
Use Docker
docker model run hf.co/FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "FadedRedStar/Qwen3.5-9B-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": "FadedRedStar/Qwen3.5-9B-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/FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
- Ollama
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with Ollama:
ollama run hf.co/FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
- Unsloth Studio
How to use FadedRedStar/Qwen3.5-9B-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 FadedRedStar/Qwen3.5-9B-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 FadedRedStar/Qwen3.5-9B-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 FadedRedStar/Qwen3.5-9B-heretic-GGUF to start chatting
- Pi
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FadedRedStar/Qwen3.5-9B-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": "FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FadedRedStar/Qwen3.5-9B-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 FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
- Docker Model Runner
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with Docker Model Runner:
docker model run hf.co/FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
- Lemonade
How to use FadedRedStar/Qwen3.5-9B-heretic-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull FadedRedStar/Qwen3.5-9B-heretic-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Qwen3.5-9B-heretic-GGUF-Q4_K_M
List all available models
lemonade list
- 🤖 Qwen3.5-9B-heretic — GGUF
🤖 Qwen3.5-9B-heretic — GGUF
This repository hosts GGUF weights and the associated vision projection matrix for Qwen3.5-9B-heretic, quantized from the source floating-point tensors provided by coder3101/Qwen3.5-9B-heretic.
🔄 Sister Repository: Check out the Imatrix Sister Repository for enhanced precision at lower bit fractions.
If you plan on using 4-bit or 5-bit variants, consider the imatrix sister repository instead — importance matrix calibration improves logic retention at those bit depths. This repository is best suited if you want the near-lossless
Q8_0build.
ℹ️ Model Profile & Core Features
Qwen3.5-9B is a vision-language model by the Qwen Team (Alibaba) with a hybrid architecture combining Gated Delta Networks and sparse Mixture-of-Experts (MoE) for high-throughput inference with minimal latency. The model supports 201 languages and dialects, integrates a native vision encoder via early-fusion multimodal training, and was post-trained with reinforcement learning at scale across million-agent environments. It natively supports tool calling, agentic pipelines, and extended context up to 262,144 tokens. The model thinks by default, generating reasoning content before its final response.
The heretic suffix denotes post-processing via Heretic v1.2.0 with the Multi-directional refusal suppression method performed by coder3101, which simultaneously targets multiple refusal directions across model layers to achieve a thorough and stable abliteration.
📋 Technical Specifications
| Property | Value |
|---|---|
| Base Architecture | Qwen3.5 hybrid (Gated Delta Networks + sparse MoE) |
| Developed by | Qwen Team (Alibaba) |
| Parameters | 9B language backbone (~10B total with vision encoder) |
| Primary Use | Multimodal reasoning, coding, tool use, agentic tasks |
| Context Window | 262,144 tokens (extensible to ~1M) |
| Vision Encoder | Integrated (early-fusion) |
| Languages | 201 languages and dialects |
| Abliteration Tool | Heretic v1.2.0 |
| Abliteration Method | Multi-directional refusal suppression |
| Prompt Format | ChatML |
🛠️ Heretic Overrides (ARA)
| Property | Value |
|---|---|
| direction_index | 14.33 |
| attn.o_proj.max_weights | [0: 1.04, 1: 1.49, 2: 1.07, 3: 1.31] |
| attn.o_proj.max_weight_position | 20.19 |
| attn.o_proj.min_weights | [0: 0.06, 1: 0.73, 2: 0.17, 3: 0.54] |
| attn.o_proj.min_weight_distance | 16.54 |
| mlp.down_proj.max_weights | [0: 1.47, 1: 0.82, 2: 1.06, 3: 1.24] |
| mlp.down_proj.max_weight_position | 20.06 |
| mlp.down_proj.min_weights | [0: 0.55, 1: 0.13, 2: 0.57, 3: 1.00] |
| mlp.down_proj.min_weight_distance | 11.39 |
📊 Refusal Bypass Metrics
The metrics below are self-reported by the original model author (coder3101) and have not been independently reproduced.
| Metric | This model | Original (Qwen/Qwen3.5-9B) |
|---|---|---|
| KL divergence | 0.1334 | 0 (by definition) |
| Refusals | 10/100 | 86/100 |
🧮 Numerical & Tensor Formats
| Property | Value |
|---|---|
| Text Tensors | Q4_K_M, Q5_K_M, Q8_0 |
| Vision Tensors | Q8_0, BF16 |
📦 Available Model Files
Main model weights
| Filename | Quantization | llama.cpp Build | Size | Download |
|---|---|---|---|---|
Qwen3.5-9B-heretic-Q4_K_M.gguf |
Q4_K_M |
b9803 |
5.24 GB | 📥 Download |
Qwen3.5-9B-heretic-Q5_K_M.gguf |
Q5_K_M |
b9860 |
6.02 GB | 📥 Download |
Qwen3.5-9B-heretic-Q8_0.gguf |
Q8_0 |
b9860 |
8.87 GB | 📥 Download |
mmproj — vision projector files
| Filename | Quantization | Size | Download |
|---|---|---|---|
mmproj-Qwen3.5-9B-heretic-Q8_0.gguf |
Q8_0 |
595 MB | 📥 Download |
mmproj-Qwen3.5-9B-heretic-BF16.gguf |
BF16 |
879 MB | 📥 Download |
mtp — speculative decoding draft files
| Filename | Quantization | Size | Download |
|---|---|---|---|
mtp-Qwen3.5-9B-heretic-Q8_0.gguf |
Q8_0 |
2.02 GB | 📥 Download |
mtp-Qwen3.5-9B-heretic-BF16.gguf |
BF16 |
3.80 GB | 📥 Download |
🎛️ Component Pairing Guide
Download exactly one main weights file:
Q4_K_M: Balanced 4-bit format suitable for most everyday use.Q5_K_M: Higher-fidelity mid-range format recommended as a general default.Q8_0: Near-lossless 8-bit format for when memory is not a constraint.
mmproj files (optional): multimodal vision projectors. Pass one via the --mmproj flag in llama.cpp to enable image input.
BF16(Recommended): Highest possible image processing accuracy. While older projectors were small, modern vision towers can hover around 1GB. If you are tight on VRAM, it is completely viable to run this on system RAM (CPU) with a minimal performance penalty, saving your precious GPU space for the main model layers.Q8_0: Cuts the projector file size and memory footprint in half (~500MB for larger 1GB files). Use this if you prefer to keep the vision tower hosted entirely on your GPU but need to claw back some VRAM to avoid Out-Of-Memory (OOM) crashes.
mtp files (optional): multi-token-prediction draft models for speculative decoding. Pass one via the --draft flag in llama.cpp to speed up generation.
BF16(Best Speed): Maximizes draft accuracy. The more accurate the draft model's predictions are, the higher your token acceptance rate, which translates directly into faster text generation. Use this if you have the VRAM headroom.Q8_0(Best VRAM Efficiency): Cuts the draft model size in half. Choose this if loading a heavyBF16draft model would force you to drop layers of your main model to system RAM, which would heavily tank your total performance.
⚡ Deployment & Execution Commands
The vision projector (
--mmproj) must be supplied at runtime whenever image inputs are used. Omitting it disables multimodal capability entirely.
Qwen recommends the following sampling configuration for best results:
- Thinking mode for general tasks:
temperature=1.0,top_p=0.95,top_k=20,min_p=0.0,presence_penalty=1.5,repetition_penalty=1.0- Thinking mode for precise coding tasks (e.g., WebDev):
temperature=0.6,top_p=0.95,top_k=20,min_p=0.0,presence_penalty=0.0,repetition_penalty=1.0- Instruct (or non-thinking) mode for general tasks:
temperature=0.7,top_p=0.8,top_k=20,min_p=0.0,presence_penalty=1.5,repetition_penalty=1.0- Instruct (or non-thinking) mode for reasoning tasks:
temperature=1.0,top_p=0.95,top_k=20,min_p=0.0,presence_penalty=1.5,repetition_penalty=1.0
This model thinks by default and will emit reasoning content before its final answer. To disable this, set
enable_thinking: Falseif your inference stack supports it; standard llama.cpp does not expose this toggle directly, so expect reasoning output unless you strip it client-side.
Swap the
-mfilename below for either quantized file depending on your size/quality trade-off preference.
llama.cpp CLI (with image)
./llama-cli \
-m Qwen3.5-9B-heretic-Q4_K_M.gguf \
--mmproj mmproj-Qwen3.5-9B-heretic-Q8_0.gguf \
-c 8192 \
-ngl 99 \
--image "path/to/image.jpg" \
-p "<|im_start|>user\nDescribe what you see and answer any questions about the image.<|im_end|>\n<|im_start|>assistant\n"
Speculative Decoding (MTP Acceleration)
./llama-cli \
-m Qwen3.5-9B-heretic-Q4_K_M.gguf \
--draft mtp-Qwen3.5-9B-heretic-Q8_0.gguf \
-c 8192 \
-ngl 99 \
-p "<|im_start|>user\nDescribe what you see and answer any questions about the image.<|im_end|>\n<|im_start|>assistant\n"
OpenAI-Compatible API Server
./llama-server \
--host 0.0.0.0 \
--port 8080 \
-m Qwen3.5-9B-heretic-Q4_K_M.gguf \
--mmproj mmproj-Qwen3.5-9B-heretic-Q8_0.gguf \
-c 16384 \
-ngl 99 \
--flash-attn
💬 Chat Templates & Prompt Design (ChatML)
<|im_start|>system
You are a helpful multimodal assistant.<|im_end|>
<|im_start|>user
Your question or image payload here.<|im_end|>
<|im_start|>assistant
⚠️ Safety & Operational Notes
- This model is abliterated and will generate content that standard aligned models refuse. Use responsibly and in compliance with applicable laws.
- Vision tensors are kept at BF16 or Q8_0 depending on the mmproj variant chosen, to preserve spatial feature quality.
- Speculative decoding via the accompanying
mtpdraft model can meaningfully increase throughput on supported llama.cpp builds. - For better output quality at this quantization level, consider the imatrix variant in the companion repository.
- Downloads last month
- 1,518
4-bit
5-bit
8-bit
16-bit