Skip to content

Liquid AI LFM: On-Device Reasoning and Agent Workflows

Oct 10, 20261 min
TL;DRLFM2.5-2.6B is an on-device hybrid reasoning model; checkpoint and OpenRouter context limits differ, with license and data terms to check before deployment.

🌏 中文版

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 linePositioningKey differencesAccess
LFM2.5-2.6B checkpointOn-device text reasoning and agents2.69B; 131,072 tokens; hybridOfficial weights; LFM Open License v1.0
LFM2.5-2.6B hosted endpointAPI trial65,536 tokens; 8,192 maximum outputOpenRouter liquid/lfm-2.5-2.6b:free

Separate the checkpoint from the endpoint

ItemVerified description
CheckpointLiquidAI/LFM2.5-2.6B
ParametersModel card: 2.69B; product name: 2.6B
Official context131,072 tokens
OpenRouter free endpoint context65,536 tokens
OpenRouter maximum output8,192 tokens
ModalityThis checkpoint is text-only
ArchitectureHybrid short convolutions and grouped-query attention
Weight licenseLFM 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

StageAction
Document RAGTest questions with source passages and check citations
ExtractionCompare fields and null values with human labels
Tool workflowsValidate function names, arguments, and recovery
Local deploymentFix hardware and quantization; measure latency and memory
IntegrationCheck 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