alt.freeweights.lfm / LFM3-VL-2B-OptiQ-4bit
From: mlx-community <huggingface.co/mlx-community>Newsgroups: alt.freeweights.lfmSubject:

LFM3-VL-2B-OptiQ-4bit

Date: 2026-11-15Commit: 7319a2eSigned: 2DC28CC7B26A283B ✓

Image text to text model with 1.7B parameters. Safetensors weights, 1.71 GB in all. Published by mlx-community under LFM-1.0 (custom).

1.7B params1.71GBLFM3-VL-2B-OptiQ-4bitsafetensorscustom terms
FactsParams1.7BSize1.71 GBFormatssafetensorsTaskimage text to textLicenseLFM-1.0 (custom)From sourcecustom termsread terms
# custom terms: read the license before you download
$ fw get mlx-community/LFM3-VL-2B-OptiQ-4bit
# manifest sha256 5ced23897e95… · 1.71 GB · 22 files
$ fw verify ./LFM3-VL-2B-OptiQ-4bit mlx-community/LFM3-VL-2B-OptiQ-4bit
From sourceHosted (signed)mlx-community/LFM3-VL-2B-OptiQ-4bitLast check: 2026-11-15 00:21 UTC

Get help: custom fine-tune or private deploy. We review your setup before we quote.

Quantized of LFM3-VL-2B.

Works with

Overview

Size
1.71 GB
Weights
1.69 GB (safetensors)
Parameters
1.7B
Formats
safetensors
Task
image text to text
License
LFM-1.0 (custom) (custom)
Files
22, each with a sha256
Publisher
mlx-community
Added
2026-11-15
Section
alt.freeweights.lfm
Lineage

Original release from the publisher.

Base model: LiquidAI/LFM3-VL-2B

Where these bytes come from
Publisher at the pinned commit→You

Sources are tried in order. A file counts only when its size and sha256 match the manifest. Sources are checked when you ask for them, not on a timer.

Sources
BadgeHostLast checkResult
From sourcehuggingface.co2026-11-15 00:21 UTCpassed

Model card

From the publisher at commit 7319a2e. Shown as plain text with links; images open at the publisher.

mlx-community/LFM3-VL-2B-OptiQ-4bit#

Built with mlx-optiq, the MLX-native toolkit to quantize, fine-tune, and serve LLMs locally on Apple Silicon, no PyTorch and no cloud. All OptiQ quants · Docs

An OptiQ mixed-precision quant of LiquidAI/LFM3-VL-2B, Liquid's LFM3 vision-language model. It reads images and text and answers in text. It is 1.7 GB on disk, down from 3.9 GB at bf16, with a 128k context.

The language model is the LFM3 backbone: short convolutions and attention, with sliding-window attention, so only 6 of its 24 layers keep a full-length KV cache. OptiQ measures each layer's sensitivity and assigns its bit-width from that. The vision tower stays at bf16 in a sidecar, optiq_vision.safetensors.

What it is#

PropertyValue
BaseLiquidAI/LFM3-VL-2B
Architecturelfm3_vl: LFM3 language model (24 layers: 13 convolution, 5 sliding-window attention of 256 tokens, 6 full attention) plus a vision tower
MethodOptiQ mixed-precision, sensitivity-driven (bf16 reference); vision tower at bf16
On disk1.7 GB (bf16: 3.9 GB)
Context128k

About half of the language model's weight matrices stay at 8-bit (75 of 153), the ones whose quantization moved the output most. The rest are at 4-bit.

Capability Score#

Six-metric mean, the standard OptiQ eval, run in reasoning mode because the model thinks before it answers by default. The baseline is a uniform 4-bit quant of the same model, scored the same way.

MetricOptiQUniform 4-bit
MMLU (generative)68.9%70.6%
GSM8K83.2%76.4%
IFEval (strict)44.4%35.7%
BFCL-V3 simple (200 calls)91.0%90.5%
HumanEval (164 problems, pass@1)55.5%43.9%
HashHop (long-context retrieval)3.0%0.0%
Capability Score (mean of 6)57.6752.85

The OptiQ quant is ahead by 4.8 points overall, with the largest gains on code (+11.6), instruction following (+8.7) and math (+6.8).

Run it#

pip install -U mlx-optiq
optiq serve --model mlx-community/LFM3-VL-2B-OptiQ-4bit

That gives you an OpenAI and Anthropic compatible endpoint that takes images as well as text, with mixed-precision KV cache (kv_config.json in this repo), tool calling, and prompt caching. Send an image as an image_url content part, as with any OpenAI vision request.

The model reasons before it answers, so give it a generous max_tokens. Liquid's recommended sampling (temperature 0.1, top_k 50, repetition_penalty 1.1) ships in generation_config.json, and optiq serve applies it automatically.

Files

22 files · 1.71 GBWeights 1.69 GB (safetensors). Sizes and sha256 from the signed manifest.
Show all 22 files with their sha256
FileSizesha256
.gitattributes1.57 KB34448b82c17d60fec9b65b1f093c115ddbaadc04beb1b0140b6bfed2e012a930
README.md3.39 KB4d438e98fac1e69fb21b8b93b27fb617b0c0c8562f14a741dfcdeaa44fbb89a9
chat_template.jinja12.1 KBf45005c50cd2a97329722bf3a2dee9f16c04cdf825a589b280fb7e99e6827818
config.json34.9 KB6f801efccaa658df91b827067a557561c25ffd976760c3ebc69d5247d6eae155
configuration_lfm3.py6.11 KBdd2f4b18eed69f3a303dbf438a5ecd20d6375abad8d1aa62699b3d5294e6a71a
configuration_lfm3_vl.py9.14 KBddd68fa327d634db8bbaade1080264dc1206be613db6fbc3521998251a00e2a5
generation_config.json323 B30b1115bcdc4e5671567a5b1255a2f3d2f5a912a79292051c6f1e9db81b5e8c4
image_processing_lfm3_vl.py12.0 KB57db0cfa668bf89a6ff898874e1321e78c257d200f25c98e0ea52b30b8740088
kv_config.json724 B06cabd63988c2040e3b280bd37f54d48175b38f6a7d069dd85477dcdf93744d8
lfm3_conv.py8.53 KB80d4a985382a22774212759248a6b4c737bfbf9c2a47b3dd7f797dda748e4bb4
model.safetensors1.31 GBb3373914862fe2eb025d327243cd512244a5bf3d24902867e9a907b56eb71f26
model.safetensors.index.json59.3 KB4423b6b4161686c8b50216db85f35c8cb39e40068d23a49aee1fce5f4b117b66
modeling_lfm3.py42.3 KB4a676bee2cf184d51a9dacbb9d7c4abae85515a042a920f8e2578b22bba3d6e8
modeling_lfm3_vl.py45.0 KBa41cbe7242f379808bcc005207ee0d7b1709528966c1e4da46baa7c41827ac79
optiq/metadata.json16.0 KB373a2fbb12313b3e95ebd7c97c70090cdb9525fca30172b1eb1ec857c9d02776
optiq/sensitivity.json36.7 KBb6d63007159a9aae10fab785ff9188e66000a88d7779a907157a8bf5f4fa3380
optiq_vision.safetensors379 MBbf409123e3663c261dd137499501ee9533d113ff54a83324801f41f3acb359bf
processing_lfm3_vl.py12.2 KBd770011e71c8b8e94ea9436d4f6768b42db60c5db70145d47f326f5d76f633f6
processor_config.json1.53 KBd3d5c3f9dc3d3f25c3177ba8bb05938b53c51799244af1ca6406cde78924b84e
tokenizer.json17.9 MBa39eed58008cbcbc09e5b629b81338a654269c64cd13348aaa6090f4db75c7e7
tokenizer_config.json1.80 KBd4a6138a6dda5c1c8980c7448f09be5bf723ccc252c81dbfef5e26c7a2c92fc1
video_processing_lfm3_vl.py17.2 KB9a6b7804c520b59ae6a20bff4814196c187ef5b3ed8c93cbd7d0a9a66c413478
VersionsEach time the pinned upstream commit or file list changed in this repo. Newest first.
Upstream commitDateContents
7319a2eeba pinned now2026-11-15 00:21 UTC22 files · 1.71 GB

Use it

# custom terms: read the license before you download
$ fw get mlx-community/LFM3-VL-2B-OptiQ-4bit
# manifest sha256 5ced23897e95… · 1.71 GB · 22 files
$ fw verify ./LFM3-VL-2B-OptiQ-4bit mlx-community/LFM3-VL-2B-OptiQ-4bit
Terms that come with these files. LFM 1.0: commercial use only for organisations under US$10M annual revenue. Keep a copy of the license with the files.
Custom license (custom). Read the license text first. Open this panel to show the commands once you accept its terms.
fw.pyChecks the signature and every sha256, tries each source in order, resumes.
$ python3 fw.py get https://freeweights.allternit.com/manifests/mlx-community/LFM3-VL-2B-OptiQ-4bit.json --dir ./LFM3-VL-2B-OptiQ-4bit $ python3 fw.py verify ./LFM3-VL-2B-OptiQ-4bit ./mlx-community__LFM3-VL-2B-OptiQ-4bit.json
hfThe Hugging Face CLI with one setting. Same repo id.
$ HF_ENDPOINT=https://freeweights.allternit.com hf download mlx-community/LFM3-VL-2B-OptiQ-4bit --revision 7319a2eeba21b1e6f58468a5c91183a780319e31 --local-dir ./LFM3-VL-2B-OptiQ-4bit
transformersLoad the weights in Python.
import os os.environ["HF_ENDPOINT"] = "https://freeweights.allternit.com" from transformers import AutoModelForImageTextToText, AutoProcessor processor = AutoProcessor.from_pretrained("mlx-community/LFM3-VL-2B-OptiQ-4bit", revision="7319a2eeba21b1e6f58468a5c91183a780319e31") model = AutoModelForImageTextToText.from_pretrained("mlx-community/LFM3-VL-2B-OptiQ-4bit", revision="7319a2eeba21b1e6f58468a5c91183a780319e31", device_map="auto")
vLLMServe an OpenAI-compatible API.
$ HF_ENDPOINT=https://freeweights.allternit.com vllm serve mlx-community/LFM3-VL-2B-OptiQ-4bit --revision 7319a2eeba21b1e6f58468a5c91183a780319e31

License

Name
LFM Open License v1.0
Id
LicenseRef-LFM-1.0
Class
Custom terms
Redistribution
click-through
Listing
Hosted (signed)
Terms
LFM 1.0: commercial use only for organisations under US$10M annual revenue. Keep a copy of the license with the files.
Decided
License as declared by the publisher. No person read it. 2026-11-15
Text in
README.md
Text sha256
4d438e98fac1e69fb21b8b93b27fb617b0c0c8562f14a741dfcdeaa44fbb89a9
Terms gate
Yes. The commands stay folded until you open them after reading the license.

Read the license text

Licenses are checked against the license table. A custom license passes only after a person reads it.

Provenance

From: mlx-community <huggingface.co/mlx-community>Newsgroups: alt.freeweights.lfmSubject: LFM3-VL-2B-OptiQ-4bitDate: 2026-11-15Commit: 7319a2eSigned: 2DC28CC7B26A283B ✓
Upstream
mlx-community/LFM3-VL-2B-OptiQ-4bit
Pinned commit
7319a2eeba21b1e6f58468a5c91183a780319e31
Manifest
LFM3-VL-2B-OptiQ-4bit.json · .minisig
Manifest sha256
5ced23897e95ad40858d02be928c9813c0c1f7f007eb4cceea1c1dd6b2302537
Signature
minisign, Ed25519, key 2DC28CC7B26A283B
Created
2026-11-15 00:21 UTC
Generator
freeweights-manifest/0.1.0
Takedowns
None.

How to verify

$ curl -O https://freeweights.allternit.com/manifests/mlx-community/LFM3-VL-2B-OptiQ-4bit.json $ curl -O https://freeweights.allternit.com/manifests/mlx-community/LFM3-VL-2B-OptiQ-4bit.json.minisig $ minisign -Vm LFM3-VL-2B-OptiQ-4bit.json -P RWQ7KGqyx4zCLXtUFOqvfv8L3g+8fpKJ1FsuxPyOYMF+4KufbUxKq1Oq $ shasum -a 256 <file> # compare with the Files tab

A manifest whose signature fails must be rejected. A file whose size or sha256 does not match must be discarded. Verify a download

Model tree

Parent

LiquidAI/LFM3-VL-2B · this model is a quantization of it

No model in the catalog names this one as its parent.

Get it
Read license, then download
$ HF_ENDPOINT=https://freeweights.allternit.com hf download mlx-community/LFM3-VL-2B-OptiQ-4bit
Open in Freeweights Studio

Pull, verify and run it in the Allternit app on Desktop, web or phone.

Signed manifest
minisign, key 2DC28CC7B26A283B. LFM3-VL-2B-OptiQ-4bit.json. Provenance. Takedown history: none.
From: LiquidAI <huggingface.co/LiquidAI>Subject: LFM2-1.2B
From: LiquidAI <huggingface.co/LiquidAI>Subject: LFM2-1.2B-Extract
From: LiquidAI <huggingface.co/LiquidAI>Subject: LFM2-1.2B-RAG
From: LiquidAI <huggingface.co/LiquidAI>Subject: LFM2-1.2B-Tool
From: LiquidAI <huggingface.co/LiquidAI>Subject: LFM2-2.6B
From: LiquidAI <huggingface.co/LiquidAI>Subject: LFM2-2.6B-Exp