Skip to content

docs: document Qwen3.8-Flash-Next as blocked (qwen4_exp architecture) - #52

Merged
elbruno merged 2 commits into
mainfrom
docs/qwen3.8-flash-next-blocked
Aug 26, 2026
Merged

elbruno merged 2 commits into
mainfrom
docs/qwen3.8-flash-next-blocked

Conversation

@elbruno

@elbruno elbruno commented Aug 26, 2026

Copy link
Copy Markdown
Owner

Summary

Investigated adding Qwen3.8-Flash-Next (unsloth/Qwen3.8-Flash-Next-GGUF → canonical Qwen/Qwen3.8-Flash-Next) to the model catalog per user request. Verified it is blocked for ONNX conversion and documented findings in docs/blocked-models.md.

Findings

  • Canonical HF repo: Qwen/Qwen3.8-Flash-Next (safetensors, not just the unsloth GGUF repackaging)
  • architectures: ["Qwen4ExpForConditionalGeneration"], model_type: "qwen4_exp" — an experimental preview of the Qwen4 architecture (not Qwen3), combining hybrid linear/sparse attention (Gated DeltaNet + Qwen Sparse Attention), 512-expert MoE, a novel Gated Residual mechanism, and a 51B-param N-gram Embedding table, plus a vision encoder (multimodal).
  • Live-verified failure: ran python -m onnxruntime_genai.models.builder (v0.15.1, this repo's pinned version) against the real HF repo in config_only mode — fails immediately because transformers 5.14.1 (newest available) doesn't recognize qwen4_exp at all (KeyError: 'qwen4_exp' in CONFIG_MAPPING), before onnxruntime-genai's own architecture dispatch table is even reached.
  • GitHub code search of microsoft/onnxruntime-genai confirms zero occurrences of qwen4_exp, indexer_budget, hc_lowrank, or ngram_vocab_size_base anywhere in the repo — no partial support exists.
  • License: Qwen Community License 1.0 (new class for this catalog — revenue/MAU-gated notice + MaaS licensing carve-out).

Change

Adds a new "Qwen3.8-Flash-Next" section to docs/blocked-models.md (under Next-Gen Models) following the existing Nemotron 3.5 Lightning / Muse Glimmer template: architecture table, verified dispatch findings, what would unblock it, and recommended alternatives (GGUF via llama.cpp/Unsloth, or Qwen3-14B-Instruct / Qwen2.5-32B-Instruct for native ONNX).

No KnownModels.cs entry added — this model stays out of the ONNX-backed catalog until/unless a working conversion path exists.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Verified via live onnxruntime-genai builder run (config_only) against
Qwen/Qwen3.8-Flash-Next: the qwen4_exp architecture is not recognized
by transformers 5.14.1 and has zero footprint in onnxruntime-genai's
builder source (indexer_budget, hc_lowrank, ngram_vocab_size_base,
qwen4_exp all return 0 GitHub code search results). Adds a new
blocked-models.md entry following the Nemotron/Muse Glimmer template.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@elbruno
elbruno merged commit 8f6be5a into main Aug 26, 2026
@elbruno
elbruno deleted the docs/qwen3.8-flash-next-blocked branch August 26, 2026 17:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant