gitwtfhub

wtf is minivlmdoceval?

sajjadpsavoji/minivlmdoceval — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 4/5Setup · hard

TL;DR

A research evaluation of six small vision language models under 1 billion parameters on five document understanding benchmarks.

Mindmap

mindmap
  root((MiniVLMDocEval))
    What it does
      Evaluates six small VLMs
      Five document benchmarks
      Knowledge gap analysis
    Findings
      Qwen3.5 strongest
      Resolution beats scale
      Table lookup is weakest
    Reproduce
      Colab notebook
      Two phase scripts
      Fixed seed and sample size
    Audience
      ML researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Compare small vision language models like Qwen3.5-0.8B and InternVL3-1B on document QA tasks

REASON 2

Reproduce a benchmark study of six sub-1B VLMs using a fixed seed and pinned dependencies

REASON 3

Study why table based visual question answering is harder for small models than other document tasks

What's in the stack?

PythonVLMEvalKitPyTorch

How it stacks up

sajjadpsavoji/minivlmdoceval0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/54/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires a CUDA GPU and two incompatible transformers versions run in separate phases.

The README does not state a license.

Wtf does this do

MiniVLMDocEval is a research project that tests whether small vision language models, meaning AI models that can read both images and text but have under one billion parameters, are good enough for document understanding tasks. The author evaluated six open source models under one billion parameters against five different document benchmarks, then analyzed where the best model still struggles and tried a targeted fix. Across benchmarks covering chart reading, document question answering, information extraction from images, text recognition accuracy, and table based question answering, a model called Qwen3.5, at 0.8 billion parameters, came out on top overall. Interestingly, the smallest model tested, at 0.45 billion parameters, still beat two larger 0.9 billion parameter models and won the chart reading benchmark outright, suggesting that how a model processes image resolution matters more than raw parameter count. Across all six models, the weakest area by far was visual table lookup, especially in a Wikipedia style table format, while the same models did comparatively well on financial tables. The author then tried to close that table reading gap with a targeted fine tuning approach called LoRA, but the attempt failed a pre registered check meant to catch models that get worse elsewhere while improving on one task: after fine tuning, table performance dropped sharply and document question answering performance also fell. The report treats this as a useful finding in itself, tracing the failure to a mismatch between how the model was trained to answer and how it was scored, and it proposes a corrected approach. The project is built on top of an existing evaluation toolkit called VLMEvalKit, pinned to a specific version, and everything is designed to be reproduced exactly, using fixed random seeds and a fixed sample size. Reproducing the full set of experiments requires a CUDA capable graphics card and works either through a provided Colab notebook or a set of command line scripts. The repository does not state a license.

Yoink these prompts

Prompt 1
Explain why Qwen3.5-0.8B outperformed larger models in this evaluation
Prompt 2
Walk me through reproducing Phase A and Phase B of this benchmark in Colab
Prompt 3
Summarize the LoRA fine tuning failure described in Part 2 of the report
Prompt 4
Show me how the regression gate script decides whether a fine tuned model passes

Frequently asked questions

wtf is minivlmdoceval?

A research evaluation of six small vision language models under 1 billion parameters on five document understanding benchmarks.

What language is minivlmdoceval written in?

Mainly Python. The stack also includes Python, VLMEvalKit, PyTorch.

What license does minivlmdoceval use?

The README does not state a license.

How hard is minivlmdoceval to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is minivlmdoceval for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.