whatisgithub

What is small-vlm-sop-check?

shure-dev/small-vlm-sop-check — explained in plain English

Analysis updated 2026-05-18

47PythonAudience · researcherComplexity · 4/5LicenseSetup · moderate

In one sentence

This project trains and evaluates small vision-language models that watch first-person factory video and detect exactly when each work step starts and ends, to catch procedure errors early.

Mindmap

mindmap
  root((sop-check))
    What it does
      Temporal grounding
      Factory procedure checking
      Small VLM benchmarking
    Tech stack
      Python
      MLX
      Qwen3-VL models
    Use cases
      Model benchmarking
      Video annotation
      Fine-tuning data export
    Scope
      Offline evaluation only
      Not real-time yet
      Not for automated safety decisions

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

What do people build with it?

USE CASE 1

Benchmark small vision-language models on detecting the exact timing of actions in first-person factory video.

USE CASE 2

Annotate factory videos with event descriptions and time ranges using the built-in web app.

USE CASE 3

Export labeled video data to fine-tune a small model for a specific factory's procedures.

What is it built with?

PythonMLXQwen3-VLApple Silicon

How does it compare?

shure-dev/small-vlm-sop-checkhayder-rzaigui/haxderjameslhw/polymarket-quick-trade
Stars474747
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity4/53/53/5
Audienceresearcherops devopsdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Python 3.10+, ffmpeg, and agreeing to Hugging Face dataset terms to download the Factory Ego videos.

MIT license for the code, use freely including commercially, but the video dataset and any models have their own separate licenses.

So what is it?

This project is a research toolkit for catching mistakes in factory work procedures before they turn into accidents or quality problems. It uses small vision-language models, the kind of AI that can look at video and answer questions about it, to watch first-person video from a worker's camera and figure out what step of a procedure is happening. The core task the project focuses on is called temporal grounding. You give the model a video and a description of an action, such as a worker tipping a bag to drop parts into a container, and the model returns the exact start and end time of that action in the video, or says it does not happen at all. Knowing precisely when each step starts and ends makes it possible to detect skipped steps, wrong order, or actions that take unusually long, which points to a procedure error. To test this, the project uses twenty short first-person factory videos from a public dataset called Egocentric-10K, each hand-labeled in Japanese with events and exact time ranges. It compares several small AI models, all four billion parameters or smaller, on how closely their predicted time ranges match the human-labeled ones. In the current results, a model called Marlin-2B performs noticeably better than several Qwen and Gemma variants that were also tested. The repository includes a web app for annotating videos and reviewing model predictions side by side on a timeline, plus command line tools for fetching the dataset, running evaluations, and exporting labeled data for fine-tuning models with a tool called ms-swift. You can also bring your own video clips instead of using the built-in dataset. This is aimed at researchers and engineers working on factory safety or industrial AI, not general users. The authors are clear that the project currently only covers offline annotation, evaluation, and training data preparation, not real-time deployment on wearable devices, and that it should not be used on its own to automate safety-critical decisions. The code is released under the MIT license, while the video dataset and any pretrained models follow their own separate licenses.

Copy-paste prompts

Prompt 1
Explain how temporal grounding works in this project and how tIoU is used to score model predictions.
Prompt 2
Walk me through running the Quick start steps to set up factory_ego and launch sop-app.
Prompt 3
How do I add my own factory video dataset using sop-dataset and sop-app?
Prompt 4
Summarize the difference between the Temporal Grounding and Frame Classification inference methods here.

Frequently asked questions

What is small-vlm-sop-check?

This project trains and evaluates small vision-language models that watch first-person factory video and detect exactly when each work step starts and ends, to catch procedure errors early.

What language is small-vlm-sop-check written in?

Mainly Python. The stack also includes Python, MLX, Qwen3-VL.

What license does small-vlm-sop-check use?

MIT license for the code, use freely including commercially, but the video dataset and any models have their own separate licenses.

How hard is small-vlm-sop-check to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is small-vlm-sop-check for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.