🌏 中文版
Liquid AI’s LFM family emphasizes efficient deployment. This guide focuses on LFM2.5-2.6B, a text reasoning model for on-device and agent workloads, available as downloadable weights and through OpenRouter. A small model can make narrowly defined tasks easier to deploy and control, but quality still needs evaluation on your data.
Checked on October 11, 2026 against the official model card, release article, and platform page. The key integration detail is that the checkpoint and hosted endpoint advertise different context limits.
Family positioning and model matrix
| Model / product line | Positioning | Key differences | Access |
|---|---|---|---|
| LFM2.5-2.6B checkpoint | On-device text reasoning and agents | 2.69B; 131,072 tokens; hybrid | Official weights; LFM Open License v1.0 |
| LFM2.5-2.6B hosted endpoint | API trial | 65,536 tokens; 8,192 maximum output | OpenRouter liquid/lfm-2.5-2.6b:free |
Separate the checkpoint from the endpoint
| Item | Verified description |
|---|---|
| Checkpoint | LiquidAI/LFM2.5-2.6B |
| Parameters | Model card: 2.69B; product name: 2.6B |
| Official context | 131,072 tokens |
| OpenRouter free endpoint context | 65,536 tokens |
| OpenRouter maximum output | 8,192 tokens |
| Modality | This checkpoint is text-only |
| Architecture | Hybrid short convolutions and grouped-query attention |
| Weight license | LFM Open License v1.0 |
The official card describes the model’s larger window; OpenRouter describes its endpoint limit. We have not established that either listing is erroneous. Treat them separately: respect API limits when calling the endpoint, and check checkpoint and runtime settings when self-hosting.
LFM2, LFM2.5, Instruct, Thinking, vision, and audio variants are not interchangeable. Text-only here describes this checkpoint. The LFM2.5-1.2B-Instruct card lists vision and audio members, so that restriction cannot be generalized to the entire family.
Family evolution
This article focuses on selecting LFM2.5-2.6B and does not compile the complete LFM family timeline. LFM2, LFM2.5, Instruct, Thinking, vision, and audio variants have distinct specifications.
Architecture and training trade-offs
Architecture and training
Liquid positions LFM2.5 as a hybrid family for on-device deployment. This checkpoint combines short convolutions with attention and receives post-training for agent tasks. Deployment conditions and tool interaction are explicit design targets, rather than assumptions inferred from parameter count.
The release article and model card describe a context-extension stage and a post-training sequence comprising supervised fine-tuning, teacher specialization, on-policy distillation, and agentic reinforcement learning. These are vendor descriptions; we have not independently reproduced training or performance results.
The card describes a model that reasons before answering. Reasoning generation consumes the output budget, so a small parameter count alone does not promise a short wait. Record input and output lengths, quantization, hardware, and concurrency when evaluating latency.
Evaluation and alternatives
Compare with larger general models on your own task suite, measuring field accuracy, tool argument errors, grounded citations, and end-to-end latency. Use other candidates for complex cross-file coding workloads rather than predicting quality from size alone.
The cited material does not supply comparable results with aligned model versions, benchmarks, harnesses, tool permissions, and inference budgets in this article. Product positioning and parameter counts do not establish a ranking; use the task checks below to compare candidates.
Licensing, pricing, and deployment
API trial
Use the actual OpenRouter model ID below. Your application supplies the input text:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENROUTER_API_KEY"],
base_url="https://openrouter.ai/api/v1",
)
response = client.chat.completions.create(
model="liquid/lfm-2.5-2.6b:free",
messages=[{"role": "user", "content": "Extract dates and events from the following text as JSON: ..."}],
max_tokens=1024,
)
print(response.choices[0].message.content)
The endpoint explicitly states that prompts and outputs may be retained and used to train Liquid models. Free access does not imply no retention, and a generic routing option should not be assumed to override provider terms. Resolve handling requirements before sending sensitive data. Local inference also requires checking whether surrounding tools send data externally.
Local deployment and licensing
The official card lists Transformers, vLLM, SGLang, llama.cpp, MLX, and LM Studio, with GGUF, ONNX, and MLX variants. Choose a runtime and checkpoint format for your hardware, start with small inputs, and increase context and concurrency gradually. Weight size is not a limit on total process memory.
Weights use LFM Open License v1.0, not Apache or MIT. Read this checkpoint’s LICENSE, particularly commercial limitations and redistribution obligations. The release article uses broader promotional language, while the actual license contains a commercial limitation. We therefore do not describe commercial use as unrestricted. Ask the provider to resolve ambiguity affecting your intended use.
Agent integration and selection
Suitable workloads
Officially recommended areas include agent workflows, tool use, extraction, RAG, and long context. Start with bounded tasks whose answers have sources: extracting fields from documents, answering over retrieved passages, or summarizing existing records.
Tool use requires an execution host
The documented loop supplies function definitions, receives model calls, executes them in the host, and returns results with the tool role. A prompt does not automatically give the model CSV access, Pandas execution, or database write access.
For quarterly revenue analysis, the host can read CSV data, validate columns, and perform calculations before the model explains the results. Reproducible code and source fields make calculations easier to inspect than asking the model to calculate unaided. This is an application design recommendation, not a workflow tested here.
Start evaluating
| Stage | Action |
|---|---|
| Document RAG | Test questions with source passages and check citations |
| Extraction | Compare fields and null values with human labels |
| Tool workflows | Validate function names, arguments, and recovery |
| Local deployment | Fix hardware and quantization; measure latency and memory |
| Integration | Check endpoint limits, data terms, and weight license |
LFM2.5-2.6B offers a route to local tool workflows. Adoption depends on passing evaluations with your tasks, data, and hardware.
Limitations and trade-offs
The official card advises against using this checkpoint for agentic coding and knowledge-heavy tasks. This selection limitation applies to LFM2.5-2.6B; evaluate other family members against their own model cards.
Update history
- 2026-10-11: Reorganized the article into the common family structure and added a model matrix using existing material; factual verification dates remain unchanged.
- 2026-10-11: Rechecked architecture and training against official sources, separated checkpoint and API context limits, added data-retention and license restrictions, and removed unmeasured performance comparisons before publication.
References
Loading...