Qwen3.8-27B-MLX-4bit

<p align="center"> <a href="https://tensorfold.dev"> <img src="https://huggingface.co/spaces/TensorFold/README/resolve/main/tensorfold-logo.png" alt="TensorFold" width="160"> </a> </p> <p align="center"> <a href="https://qwenlm.github.io/"><img src="qwen-logo.png" width="96" height="95" alt="Qwen"></a><br> <img src="https://img.shields.io/badge/Apple_Silicon-MLX-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Apple silicon MLX"> <img src="https://img.shields.io/badge/TensorFold-oMLX-6E56CF?style=for-the-badge&logo=huggingface&logoColor=white" alt="TensorFold oMLX"> </p> <h1 align="center">Qwen3.8-27B — MLX 4-bit</h1> <p align="center"> A native Apple-silicon conversion of <a href="https://huggingface.co/Qwen/Qwen3.8-27B">Qwen/Qwen3.8-27B</a>, quantized with stock 4-bit affine weights for MLX-VLM and oMLX. </p> <p align="center"> <a href="https://huggingface.co/Qwen/Qwen3.8-27B">Original model</a> · <a href="https://qwenlm.github.io/">Qwen</a> · <a href="https://github.com/Blaizzy/mlx-vlm">MLX-VLM</a> · <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0</a> </p>

About this conversion

This repository contains a stock 4-bit affine MLX conversion of Qwen3.8-27B. The upstream model is a dense, native vision-language model with flexible thinking control and support for text, images, and video. Its tokenizer, processor configuration, chat template, and generation configuration are preserved.

Apple-silicon performance

This checkpoint was load-tested and generation-tested on the following machine:

The decode figure is the median of three greedy 256-token runs after a 256-token Metal-kernel warm-up. Individual runs measured 39.90, 39.89, and 39.91 tokens/s. This is a practical local reference, not a controlled cross-platform benchmark; prompt length, context growth, sampler settings, memory pressure, thermal state, and runtime versions can materially change performance.

Quick start with MLX-VLM

python -m pip install -U mlx-vlm huggingface_hub


python -m mlx_vlm.generate \
  --model TensorFold/Qwen3.8-27B-MLX-4bit \
  --prompt "Explain the difference between linear and full attention." \
  --max-tokens 512

Download for local use:

hf download TensorFold/Qwen3.8-27B-MLX-4bit \
  --local-dir ~/.omlx/models/TensorFold/Qwen3.8-27B-MLX-4bit

Using it with oMLX

1. Place the model at ~/.omlx/models/TensorFold/Qwen3.8-27B-MLX-4bit.
2. Refresh the oMLX model registry.
3. Load Qwen3.8-27B-MLX-4bit and use the chat UI or OpenAI-compatible endpoint.

curl "$OMLX_BASE_URL/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OMLX_API_KEY" \
  -d '{
    "model": "Qwen3.8-27B-MLX-4bit",
    "messages": [{"role": "user", "content": "Write a short Swift actor example."}],
    "temperature": 1.0,
    "top_p": 0.95,
    "max_tokens": 256
  }'

For long prompts, begin with a conservative context limit and increase it while watching memory pressure. The configured context is a model capability, not a guarantee that every host can prefill it within available unified memory.

Architecture

Qwen3.8-27B is a dense causal language model with a vision encoder. It uses the Qwen3.5 architectural foundation, interleaving Gated DeltaNet linear-attention blocks with periodic full-attention blocks.

For upstream evaluations, usage guidance, intended use, limitations, safety information, and the full architecture discussion, see the original model card.

Conversion and validation notes

• Source weights: the official Qwen checkpoint.
• Quantization: stock 4-bit affine weights with group size 64.
• The upstream tokenizer, processor files, chat template, and generation configuration are preserved.
• All 2,180 converted tensors and all three indexed shards were checked locally.
• Quantization can reduce output quality relative to the source weights; use a higher-precision variant when quality matters more than memory use.
• The model was loaded and exercised through end-to-end generation on Apple silicon.

This is a community conversion, not an official Qwen release. Validate quality and numerical behaviour on your own representative workload before production use.

Licence and attribution

The upstream model is released under the Apache License 2.0. A copy is included in this repository; review it before use or redistribution.

All model design, training, benchmark, and upstream documentation credit belongs to Qwen and the original contributors. The MLX conversion, Apple-silicon validation, compatibility work, and packaging are provided by TensorFold.

<!-- TensorFold-chooser-start -->

Choose for your Mac

64GB Macs · 128GB Macs · 256GB Macs

Published peak memory: 20.14 GB; estimated starting tier: 64GB, leaving about 43 GB nominal headroom. The collections use published M3 Studio peaks with at least 25% nominal headroom; fit on other Macs is an estimate, and full context is not guaranteed. Start with short context and one request.

Runtime and evidence

The exact tested oMLX application version is not recorded here; a library version is not an app version. The original performance tables retain their benchmark conditions and speed figures; this documentation update adds no new test results.

Quick start and demo prompt

hf download TensorFold/Qwen3.8-27B-MLX-4bit --local-dir ./models/Qwen3.8-27B-MLX-4bit

Add the downloaded folder to oMLX model directories, refresh the list, and follow this card's architecture and MTP compatibility requirements before loading.

Try this in a new chat with a 128-token output limit:

Explain why the sky looks blue in three short sentences.

This is a demo prompt to try, not a recorded successful run; a captured demonstration for this documentation update is not yet available.

Follow TensorFold for new Apple Silicon releases and fixes.

<!-- TensorFold-chooser-end -->