Instructions to use donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit with MLX:
# Make sure mlx-vlm is installed # pip install --upgrade mlx-vlm from mlx_vlm import load, generate from mlx_vlm.prompt_utils import apply_chat_template from mlx_vlm.utils import load_config # Load the model model, processor = load("donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit") config = load_config("donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit") # Prepare input image = ["http://images.cocodataset.org/val2017/000000039769.jpg"] prompt = "Describe this image." # Apply chat template formatted_prompt = apply_chat_template( processor, config, prompt, num_images=1 ) # Generate output output = generate(model, processor, formatted_prompt, image) print(output) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Pi
How to use donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit"
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent
How to use donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit"
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 donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit"
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 "donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Qwen3.8-27B-heretic-VL-MLX-6bit
6-bit quantized MLX conversion of trohrbaugh/Qwen3.8-27B-heretic-ara, with the vision tower intact, for Apple Silicon.
Vision works — and was tested
This build keeps the vision encoder: vision_config is present and 333 of the 2180
tensors belong to vision_tower. It reads images.
Verified rather than assumed. A generated test image (red square left, blue circle
centre, green triangle right, the caption MAC512 VISION TEST, and the code
7391-ZQ) was fed to all four builds. Every one named the three shapes with the right
colours and positions and read both strings back exactly.
Requires mlx-vlm, not mlx-lm. mlx-lm converts the language tower only and
would silently drop vision. Text-only siblings live at
Qwen3.8-27B-heretic-MLX-*
— smaller and slightly leaner if you never send images.
What this is
The base model is an abliterated ("heretic") derivative of Qwen/Qwen3.8-27B: its refusal behaviour has been surgically removed, so it will answer prompts a safety-tuned model would decline. This repo only changes the format and precision — it adds no alignment, and removes none either. Evaluate it before putting it in front of users, and apply your own filtering where your use case needs it.
Lineage: Qwen/Qwen3.8-27B → trohrbaugh/Qwen3.8-27B-heretic-ara → this MLX build.
The full set
| Build | Size | Bits/weight | Generation | Peak memory |
|---|---|---|---|---|
| 4-bit | 15.0 GB | 4.695 | 38.9 tok/s | 19.2 GB |
| 6-bit | 21.3 GB | 6.661 | 29.2 tok/s | 27.0 GB |
| 8-bit | 27.5 GB | 8.627 | 23.1 tok/s | 34.7 GB |
| bf16 | 51.0 GB | 16 | 13.2 tok/s | 55.8 GB |
Measured on a Mac Studio M3 Ultra (512 GB unified memory), macOS 26.5.2, mlx-vlm 0.6.13,
470-token multimodal prompt (image + text). Single run, one machine, one prompt — an
order-of-magnitude guide, not a benchmark. Prompt processing ran at 303-331 tok/s across
all four builds; the spread between builds shows up in generation, not prefill.
This repo is the 6-bit build: 21.3 GB, 5 shards, 29.2 tok/s, 27.0 GB peak memory.
Peak memory runs roughly 4-6 GB above the text-only sibling — that is the vision tower plus image-patch activations.
Usage
pip install mlx-vlm
mlx_vlm.generate --model donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit \\
--image photo.png --prompt "What does this image show?" --max-tokens 256
from mlx_vlm import load, generate
from mlx_vlm.prompt_utils import apply_chat_template
model, processor = load("donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit")
prompt = apply_chat_template(processor, model.config, "What does this image show?", num_images=1)
print(generate(model, processor, prompt, ["photo.png"], max_tokens=256))
Reasoning mode
The chat template supports enable_thinking and reasoning_effort. Thinking is on by
default and consumes tokens before the answer begins, so a small max_tokens budget may
return reasoning only.
Conversion
mlx_vlm.convert --hf-path trohrbaugh/Qwen3.8-27B-heretic-ara -q --q-bits 6 \\
--mlx-path Qwen3.8-27B-heretic-VL-MLX-6bit
Converted with mlx-vlm 0.6.13 from the bf16 weights at revision
a67ae100d933c0d17af3232bda35825979fc63ce. Before conversion the source was verified:
7 shards, 1199 tensors, all safetensors headers parsed, no missing files.
License and attribution
Apache-2.0, inherited through the lineage above. Credit for the model goes to the Qwen
team at Alibaba Group's Tongyi Lab, and for the abliteration to trohrbaugh. This repo
contributes only the MLX conversion.
- Downloads last month
- 89
6-bit
Model tree for donedynamics/Qwen3.8-27B-heretic-VL-MLX-6bit
Base model
trohrbaugh/Qwen3.8-27B-heretic-ara