Update README.md

990a173 verified 2 days ago

2.77 kB

license: apache-2.0
language:
  - en
library_name: q4nx
pipeline_tag: image-text-to-text
tags:
  - qwen2.5vl-it
  - reasoning
  - remember
  - visual
  - advanced-reasoning
  - multilingual
  - fastflowlm
  - q4nx
  - npu
base_model:
  - JM-Chen/Remember-R1-3B
base_model_relation: quantized
quantized_by: Atomic-Germ

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

Remember-R1-3B - Q4NX for FastFlowLM (AMD Ryzen AI XDNA2)

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
~51 GB of unified system memory (Q4NX weights + activations + KV cache)

Files

File	Purpose
model.q4nx	Quantized Q4NX weights
config.json	FastFlowLM model configuration
tokenizer.json	Tokenizer
tokenizer_config.json	Special tokens and chat template
chat_template.jinja	Chat template (optional)
flm-add.py	Installer script - registers this model with FastFlowLM

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 minicpm4.6:0.8b. 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/Remember-R1-3B-NPU2 --tag remember-r1:3b --family qwen2vl
FLM_CONFIG_PATH="$HOME/.config/flm/model_list.json" FLM_XCLBIN_PATH="$HOME/.config/flm" flm run remember-r1: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.5vl-it:35b-a3b model (Qwen3.6-35B-A3B-NPU2), because this model shares the same engine family (qwen2.5vl-it) and architecture.

Model

Registry tag: remember-r1:3b
Engine family: qwen2.5vl-it
Kernel source: FastFlowLM/Qwen2.5-VL-3B-Instruct-NPU2
Context length: 262,144 tokens (from config)
model.q4nx size: 23.24 GB
Base model: JM-Chen/Remember-R1-3B
License: apache-2.0

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: JM-Chen/Remember-R1-3B