Instructions to use FadedRedStar/Qwen3.5-0.8B-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-0.8B-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-0.8B-heretic-GGUF", filename="Qwen3.5-0.8B-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-0.8B-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-0.8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf FadedRedStar/Qwen3.5-0.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 serve -hf FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf FadedRedStar/Qwen3.5-0.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 FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf FadedRedStar/Qwen3.5-0.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 FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M
Use Docker
docker model run hf.co/FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use FadedRedStar/Qwen3.5-0.8B-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-0.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": "FadedRedStar/Qwen3.5-0.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/FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M
- Ollama
How to use FadedRedStar/Qwen3.5-0.8B-heretic-GGUF with Ollama:
ollama run hf.co/FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M
- Unsloth Studio
How to use FadedRedStar/Qwen3.5-0.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 FadedRedStar/Qwen3.5-0.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 FadedRedStar/Qwen3.5-0.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 FadedRedStar/Qwen3.5-0.8B-heretic-GGUF to start chatting
- Pi
How to use FadedRedStar/Qwen3.5-0.8B-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-0.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": "FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use FadedRedStar/Qwen3.5-0.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 serve -hf FadedRedStar/Qwen3.5-0.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 FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use FadedRedStar/Qwen3.5-0.8B-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-0.8B-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-0.8B-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-0.8B-heretic-GGUF with Docker Model Runner:
docker model run hf.co/FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M
- Lemonade
How to use FadedRedStar/Qwen3.5-0.8B-heretic-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Qwen3.5-0.8B-heretic-GGUF-Q4_K_M
List all available models
lemonade list
Use Docker
docker model run hf.co/FadedRedStar/Qwen3.5-0.8B-heretic-GGUF:- 🤖 Qwen3.5-0.8B-heretic — GGUF
🤖 Qwen3.5-0.8B-heretic — GGUF
This repository hosts GGUF weights and the associated vision projection matrix for Qwen3.5-0.8B-heretic, quantized from the source floating-point tensors provided by coder3101/Qwen3.5-0.8B-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-0.8B is the smallest model in the Qwen3.5 lineup by the Qwen Team (Alibaba), a dense multimodal transformer supporting native vision-language understanding at extremely low compute cost. Despite its size, it inherits the family's 262,144-token context window, tool-calling support, and multilingual coverage across 201 languages and dialects, making it well suited for edge deployment and latency-sensitive agent scenarios.
The heretic suffix denotes post-processing via Heretic v1.2.0 with the Magnitude-Preserving Orthogonal Ablation (MPOA) 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 dense transformer (0.8B dense transformer) |
| Developed by | Qwen Team (Alibaba) |
| 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 | Magnitude-Preserving Orthogonal Ablation (MPOA) |
| Prompt Format | ChatML |
🛠️ Heretic Overrides (ARA)
| Property | Value |
|---|---|
| direction_index | 12.65 |
| attn.o_proj.max_weight | 1.45 |
| attn.o_proj.max_weight_position | 15.42 |
| attn.o_proj.min_weight | 0.91 |
| attn.o_proj.min_weight_distance | 8.39 |
| mlp.down_proj.max_weight | 1.17 |
| mlp.down_proj.max_weight_position | 19.22 |
| mlp.down_proj.min_weight | 0.84 |
| mlp.down_proj.min_weight_distance | 13.31 |
📊 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-0.8B) |
|---|---|---|
| KL divergence | 0.0398 | 0 (by definition) |
| Refusals | 4/100 | 96/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-0.8B-heretic-Q4_K_M.gguf |
Q4_K_M |
b9860 |
505 MB | 📥 Download |
Qwen3.5-0.8B-heretic-Q5_K_M.gguf |
Q5_K_M |
b9860 |
551 MB | 📥 Download |
Qwen3.5-0.8B-heretic-Q8_0.gguf |
Q8_0 |
b9860 |
774 MB | 📥 Download |
mmproj — vision projector files
| Filename | Quantization | Size | Download |
|---|---|---|---|
mmproj-Qwen3.5-0.8B-heretic-Q8_0.gguf |
Q8_0 |
111 MB | 📥 Download |
mmproj-Qwen3.5-0.8B-heretic-BF16.gguf |
BF16 |
198 MB | 📥 Download |
mtp — speculative decoding draft files
| Filename | Quantization | Size | Download |
|---|---|---|---|
mtp-Qwen3.5-0.8B-heretic-Q8_0.gguf |
Q8_0 |
268 MB | 📥 Download |
mtp-Qwen3.5-0.8B-heretic-BF16.gguf |
BF16 |
495 MB | 📥 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:
- Non-thinking mode for text tasks:
temperature=1.0,top_p=1.00,top_k=20,min_p=0.0,presence_penalty=2.0,repetition_penalty=1.0- Non-thinking mode for VL tasks:
temperature=0.7,top_p=0.80,top_k=20,min_p=0.0,presence_penalty=1.5,repetition_penalty=1.0- Thinking mode for text 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 VL or precise coding (e.g. WebDev) tasks :
temperature=0.6,top_p=0.95,top_k=20,min_p=0.0,presence_penalty=0.0,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-0.8B-heretic-Q4_K_M.gguf \
--mmproj mmproj-Qwen3.5-0.8B-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-0.8B-heretic-Q4_K_M.gguf \
--draft mtp-Qwen3.5-0.8B-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-0.8B-heretic-Q4_K_M.gguf \
--mmproj mmproj-Qwen3.5-0.8B-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,197
4-bit
5-bit
8-bit
16-bit
Model tree for FadedRedStar/Qwen3.5-0.8B-heretic-GGUF
Base model
Qwen/Qwen3.5-0.8B-Base
Install from pip and serve model
# Install vLLM from pip: pip install vllm# Start the vLLM server: vllm serve "FadedRedStar/Qwen3.5-0.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": "FadedRedStar/Qwen3.5-0.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" } } ] } ] }'