Qwen2.5-3B-Coder-Instruct-NPU2

IF YOU USE COMMUNITY QWEN MODELS DO NOT UPGRADE TO FLM v1.0.2+

Qwen2.5-3B-Coder-Instruct - Q4NX for FastFlowLM (AMD Ryzen AI XDNA2)

Qwen2.5-Coder-3B Instruct, converted to Q4NX for FastFlowLM. Runs on the Qwen2.5 engine (3B kernels).

What is Q4NX?

Q4NX is FastFlowLM's native packed-quantization format - a rearranged Q4_1 layout tuned for the NPU matrix engine's tile sizes and memory access patterns. It is not a GGUF file and it does not run on llama.cpp or Ollama; it is meant exclusively for the FastFlowLM engine on AMD Ryzen AI NPUs.

Requirements

• FastFlowLM >= 0.9.45 (flm CLI)
• AMD Ryzen AI processor with XDNA2 (NPU2) - Strix Point / Ryzen AI 300 series or later
• Linux with the XRT NPU stack installed
• ~8 GB of unified system memory (Q4NX weights + activations + KV cache)

Files

Install and run

This repository works with flm-add, a small installer that copies the model into the FastFlowLM user directory and registers the tag. It never modifies the system FastFlowLM install.

pip install flm-add or uv tool install flm-add

uv tool install flm-add
flm-add Atomic-Germ/Qwen2.5-3B-Coder-Instruct-NPU2 --tag qwen2.5-coder-it:3b --family qwen2.5
FLM_CONFIG_PATH="$HOME/.config/flm/model_list.json" FLM_XCLBIN_PATH="$HOME/.config/flm" flm run qwen2.5-coder:3b

Kernels

FastFlowLM's NPU kernels (xclbins) are closed source and are not shipped in this repository. flm-add.py links the kernels of the official qwen2.5-it:3b model (Qwen2.5-3B-Instruct-NPU2), because this model shares the same engine family (qwen2) and architecture.

Model

• Registry tag: qwen2.5-coder:3b
• Engine family: qwen2
• Kernel source: Qwen2.5-3B-Instruct-NPU2
• Context length: 32,768 tokens (from config)
• model.q4nx size: 2.59 GB
• Base model: Qwen/Qwen2.5-Coder-3B
• License: other

Original model card

See the upstream model card for training details, benchmarks, and upstream usage. This repository only contains the Q4NX conversion for FastFlowLM.

• Upstream card: Qwen/Qwen2.5-Coder-3B