Image-Text-to-Text
MLX
Safetensors
lfm2-vl
liquid
lfm2.5-vl
lfm2.5
edge
conversational
8-bit precision
Instructions to use LiquidAI/LFM2.5-VL-450M-MLX-8bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use LiquidAI/LFM2.5-VL-450M-MLX-8bit with MLX:
# Make sure mlx-vlm is installed # pip install --upgrade mlx-vlm from mlx_vlm import load, generate from mlx_vlm.prompt_utils import apply_chat_template from mlx_vlm.utils import load_config # Load the model model, processor = load("LiquidAI/LFM2.5-VL-450M-MLX-8bit") config = load_config("LiquidAI/LFM2.5-VL-450M-MLX-8bit") # Prepare input image = ["http://images.cocodataset.org/val2017/000000039769.jpg"] prompt = "Describe this image." # Apply chat template formatted_prompt = apply_chat_template( processor, config, prompt, num_images=1 ) # Generate output output = generate(model, processor, formatted_prompt, image) print(output) - Notebooks
- Google Colab
- Kaggle
- Local Apps
- LM Studio
- Pi
How to use LiquidAI/LFM2.5-VL-450M-MLX-8bit with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "LiquidAI/LFM2.5-VL-450M-MLX-8bit"
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "LiquidAI/LFM2.5-VL-450M-MLX-8bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use LiquidAI/LFM2.5-VL-450M-MLX-8bit with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "LiquidAI/LFM2.5-VL-450M-MLX-8bit"
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default LiquidAI/LFM2.5-VL-450M-MLX-8bit
Run Hermes
hermes
Bug: MLX checkpoint config.json has wrong model_type "lfm2-vl" (should be "lfm2_vl")
#1
by Manojb - opened
Bug
The config.json in this MLX 8-bit checkpoint uses "model_type": "lfm2-vl" (with hyphen), but HuggingFace transformers registers the architecture as "lfm2_vl" (with underscore).
The original bf16 checkpoint (LiquidAI/LFM2.5-VL-450M) correctly uses "lfm2_vl".
Steps to reproduce
from transformers import AutoModelForImageTextToText
model = AutoModelForImageTextToText.from_pretrained("LiquidAI/LFM2.5-VL-450M-MLX-8bit")
# Error: model type lfm2-vl but Transformers does not recognize this architecture
Fix
Change "model_type": "lfm2-vl" to "model_type": "lfm2_vl" in config.json.
Affected repos
- LFM2.5-VL-450M-MLX-8bit
- LFM2.5-VL-450M-MLX-6bit
- LFM2.5-VL-450M-MLX-5bit
- LFM2.5-VL-450M-MLX-4bit
- LFM2.5-VL-450M-MLX-bf16
Additional issue
Even after fixing model_type, mlx-vlm 0.4.4 fails with:
ValueError: Received 2 parameters not in model: multi_modal_projector.layer_norm.bias, multi_modal_projector.layer_norm.weight
This seems like a mlx-vlm compatibility issue with the newer LFM2.5-VL architecture.
Environment
- transformers 5.6.0.dev0
- mlx-vlm 0.4.4
- Mac Mini M4 16GB
- macOS Darwin 24.3.0
Hello,
Any update on this?