mmcheck

2 min read Original article ↗

Project description

Check if a model supports multimodal inputs.

pip install mmcheck

Quick start

from mmcheck import check

info = check("google/gemma-4-31B-it")
info.multimodal        # True
info.input_modalities  # ['text', 'image', 'video']
info.supports("image") # True
info.supports("audio") # False

CLI

mmcheck google/gemma-4-31B-it
# Model:      google/gemma-4-31B-it
# Multimodal: YES
# Inputs:     text, image, video
# Outputs:    text

mmcheck meta-llama/Llama-3-8B
# Multimodal: NO

mmcheck --json google/gemma-4-31B-it
mmcheck --offline gemma-4-31B-it

How it works

Three layers, checked in order:

  1. Built-in registry — 30+ popular models (GPT-4o, Claude, Gemini, Llama, Qwen). Instant, no network.
  2. HuggingFace Hub — fetches config.json, looks for vision_config, audio_encoder, architecture class names.
  3. vLLM cross-reference — tags models with vLLM multimodal support status.
Modality Detection
Image vision_config, vision_tower, known VLM architectures
Audio audio_config, audio_encoder, Whisper, Ultravox
Video video_config, LLaVA-Next-Video, MiniCPM-V

Gated models

For gated HuggingFace models (401/403), mmcheck falls back to the public API metadata (tags, pipeline_tag). If you want full config inspection:

export HF_TOKEN=hf_...
mmcheck google/gemma-4-31B-it

Or in Python:

info = check("google/gemma-4-27b-it", token="hf_...")

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

Filter files by name, interpreter, ABI, and platform.

If you're not sure about the file name format, learn more about wheel file names.

Copy a direct link to the current filters

File details

Details for the file mmcheck-0.2.2.tar.gz.

File metadata

  • Download URL: mmcheck-0.2.2.tar.gz
  • Upload date:
  • Size: 7.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mmcheck-0.2.2.tar.gz
Algorithm Hash digest
SHA256 92dc6b0204d19e23420de7bffae805ad109746aabae6158b3e8731d0667064f3
MD5 929158aaa47e43249a0cd64362f8de9d
BLAKE2b-256 ff1c14ee3dc6ecd08b528c455a46f03128b7699540e1f16dfcc290bdcbd03890

See more details on using hashes here.

File details

Details for the file mmcheck-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: mmcheck-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 9.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mmcheck-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e577d532111e225c5b88f4ccd291609c853a812480b0d805dcde4c46041aadc5
MD5 05692f528f81a1e163134aebd2efc9cf
BLAKE2b-256 76f04148e4f7ad3bd05d0e41076bf3f502255235da174552e62bf6da7ea2d740

See more details on using hashes here.