amad-vlm5

أمد للحلول البرمجية هي شركة عراقية مقرّها النجف الأشرف، متخصصة في تقديم الحلول البرمجية والتقنية للمنازل والشركات ودوائر الدولة. تهدف الشركة إلى بناء حلول ذكية وعملية تساعد الأفراد والمؤسسات على تطوير أعمالهم، تحسين الكفاءة، وأتمتة الإجراءات بطريقة سهلة وموثوقة.

تعمل أمد للحلول البرمجية على تقديم تقنيات حديثة تدعم التحول الرقمي، وتسهم في بناء مستقبل أكثر ذكاءً واستدامة.

amad-vlm5 is a 7B Arabic OCR vision-language model. Given an image of Arabic text — printed, handwritten, historical, scanned, or synthetic — it returns the transcription. It is fine-tuned from Qwen2.5-VL-7B-Instruct.

It is a thinking model: on dense, page-level documents it first reasons inside a <think>…</think> block and then emits the transcription. On short line-level images it usually answers directly. Your application should keep only the text after the last </think> (see Handling the thinking block).

Results on KITAB-Bench

KITAB-Bench ocr-eval, all 13 datasets, 3,760 images, scored on the final transcription only with the benchmark's unmodified metrics and Arabic normalization.

Baselines are the published KITAB-Bench numbers. Read these two caveats before quoting a rank:

1. Training overlap. 552 benchmark images (khatt 200/200, onlinekhatt 181/200, muharaf 171/200) also occur in the model's training data. Excluding those three datasets entirely, the score is CHrF 77.35 / CER 0.32 / WER 0.43 over the remaining 3,160 images.
2. Two outliers dominate CER. Two of the 3,760 outputs degenerate into a repeated phrase; without them CER is 0.13 and WER 0.28. CHrF, which is bounded, is the more stable summary.

Per-dataset results (final-answer scoring, 4,096 tokens):

Methodology note. amad-vlm5 is a thinking VLM. For OCR scoring, only the final transcription is evaluated; reasoning text is removed before metric calculation. The benchmark was run with greedy decoding in a 4-bit-quantized inference configuration; the bf16 and GGUF files in this release were not separately re-benchmarked, so small differences from the table are expected.

Files

The GGUF language model files do not work without the mmproj file — it carries the vision encoder. Download it into the same folder as the model file.

Quick start

Transformers

import re
import torch
from transformers import AutoProcessor, Qwen2_5_VLForConditionalGeneration

repo = "amad-iq/amad-vlm5"
model = Qwen2_5_VLForConditionalGeneration.from_pretrained(
    repo, dtype=torch.bfloat16, device_map="auto"
)
processor = AutoProcessor.from_pretrained(repo)

messages = [{
    "role": "user",
    "content": [
        {"type": "image", "image": "page.png"},
        {"type": "text", "text": "Extract the text in the image. Give me the final text, nothing else."},
    ],
}]
inputs = processor.apply_chat_template(
    messages, add_generation_prompt=True, tokenize=True,
    return_dict=True, return_tensors="pt",
).to(model.device)

with torch.inference_mode():
    out = model.generate(
        **inputs, max_new_tokens=4096, do_sample=False, repetition_penalty=1.05
    )
raw = processor.batch_decode(out[:, inputs["input_ids"].shape[1]:], skip_special_tokens=True)[0]
text = re.sub(r"<think>.*?</think>", "", raw, flags=re.S).strip()
print(text)

llama.cpp

llama-mtmd-cli \
  -m amad-vlm5-q8_0.gguf \
  --mmproj mmproj-amad-vlm5-f16.gguf \
  --image page.png \
  -p "Extract the text in the image. Give me the final text, nothing else." \
  -n 4096 --temp 0 --repeat-penalty 1.05

LM Studio

Search for amad-iq/amad-vlm5-GGUF in LM Studio, download a model file together with mmproj-amad-vlm5-f16.gguf, load the model, and attach an image. Set the context length to at least 8192 and the maximum output tokens to 4096 or more.

Handling the thinking block

The model may emit <think>…</think> before the transcription. <think> is ordinary text, not a special token, so it appears in decoded output. Keep only what follows the last </think>:

import re
def final_text(raw: str) -> str:
    if "</think>" in raw:
        raw = raw.rsplit("</think>", 1)[1]
    return re.sub(r"^<think>.*", "", raw, flags=re.S).strip()

If the output contains <think> but no </think>, the generation ran out of budget before finishing; raise max_new_tokens and retry.

Intended use and training data

amad-vlm5 is intended for transcribing Arabic-script text from images: books, manuscripts, forms, screenshots, and handwritten notes. It was fine-tuned on a mixture of public Arabic OCR datasets covering printed, handwritten, historical, and synthetic text, including some subsets that overlap with KITAB-Bench (see the caveat above). It is not a general assistant and has not been evaluated for languages other than Arabic and English.

Limitations

• Runaway reasoning (≈0.6% of benchmark pages). On some very dense pages the model reasons for the entire budget and never emits a transcription. Detect this by the missing </think> and retry with a larger budget or a different crop.
• Repetition loops (rare). Greedy decoding can occasionally lock onto a repeated phrase and run to the token limit. A repetition penalty of 1.05 mitigates this.
• Quantized variants are not separately benchmarked. Expect Q4_K_M to be slightly worse than Q8_0 or bf16 on handwritten and historical material.

License

Released under the Apache 2.0 license, the same license as the Qwen2.5-VL-7B-Instruct base model.