Parameters
1.7B
Architecture
Tri-hybrid decoder: 24 layers combining 13 gated short convolutions, 5 sliding-window attention, and 6 global attention
Released
27.10.2026
License
LFM Open License v1.0
Input Modalities
Output Modalities
Context (native)
262,144 tokens
Context (extended)
262,144 tokens
About
LFM3-1.7B is a text model for local agents and specialized applications and the small text flagship of Liquid AI's LFM3 family, built on the new tri-hybrid architecture. In 1.73B parameters it packs a 24-layer stack of 13 gated short convolution blocks, 5 sliding-window attention layers and 6 global attention layers; the global layers use grouped-query attention (GQA) with 16 attention heads over 4 KV heads at head dim 128 and partial rotary embeddings (rotary factor 0.5, RoPE theta 1,000,000), sliding-window layers use RoPE theta 10,000 with a 256-token sliding window, and the stack uses sandwich norm plus tied word embeddings (config.json: hidden size 2048, FFN intermediate size 7680, dtype bfloat16, model type lfm3).
The model runs with a 256K-token context window (input + output) and a 128,000-token vocabulary, and is maintained and trained by LiquidAI (Liquid AI). It speaks 16 languages: English, Arabic, Chinese, French, German, Italian, Japanese, Korean, Portuguese, Spanish, Vietnamese, Thai, Indonesian, Hindi, Russian and Polish. Reasoning is enabled by default via the <think> block of the ChatML template (enable_thinking=False can disable traces but remains inconsistent); tool calls are emitted as XML and the chat template supports deferred tools via tool search (defer_loading=True, tool_reference parts), so large tool catalogs can be searched and injected on demand.
Training. Pre-training builds LFM3-1.7B-Base on 22T tokens in two stages: main pre-training on web and synthetic data (about 15T tokens) that adds more scientific papers, repository-level code, math and a wider range of knowledge sources than LFM2, followed by 3T tokens of code, math and science at 4K context; mid-training then uses curated, higher-quality data with a large share of agentic traces and tool calls for the last 3.5T tokens at 32K context, and two context extensions (500B tokens to 128K, 50B tokens to 256K). Post-training has four stages: supervised fine-tuning (SFT) on 1.75T tokens covering chat, reasoning, tool calling and agentic traces; mixed reinforcement learning (RL) over many domains (math, code, SQL, structured outputs) with a length penalty for concision; multi-domain on-policy distillation (MOPD), where six specialist RL teachers (code, math, tool use, long context, agentic work, enterprise workflows) are distilled back into a single model; and finally agentic RL with tasks from web browsing to office work executed inside real agent harnesses such as Hermes Agent, Pi and OpenClaw.
Performance. Liquid AI states that LFM3-1.7B "can power agentic applications that used to need 9B parameters": it scores 45.60 on LiveClaw, 38.42 on WebArena-Verified, 41.29 on AutomationBench (public), 71.39 on BFCL V4, 80.36 on ToolSandbox and 43.40 on SWE-bench Verified (OpenCode agent) - beating the much larger Qwen3.5-9B on average (49.37 vs 47.24 over the whole table) and every same-size competitor. Coding and instruction following are strong for its size: 73.46 on LiveCodeBench v6, 96.66 on IFEval, 73.03 on IFBench and 93.72 on IFStruct. On-device it is equally aggressive: at 32K context it prefills at least 2.5x faster and decodes at least 1.8x faster than every compared model on the AMD Ryzen AI Max+ 395, Apple M5 Max and iPhone 17 Pro, and at 4-bit precision it fits in about 1 GB of memory. Served at 1,024 concurrent requests it produces 3.6 billion tokens per day on a single NVIDIA B300.
Usage. Recommended sampling parameters: temperature 0.1, top_k 50, repetition penalty 1.1 for general chat, tool use, agents and coding; temperature 1.0, top_p 0.95, top_k 20 for math and STEM. Checkpoints ship as BF16, FP8, NVFP4, GGUF, MLX 4-bit and ONNX for vLLM, SGLang, Transformers, llama.cpp, Ollama, LM Studio, MLX and ONNX Runtime. It is designed for local agents, tool calling, structured outputs and domain-specific fine-tuning (SFT, DPO, GRPO and CPT notebooks via TRL); not recommended for agentic coding or complex multi-step reasoning because of its size - use retrieval or search for knowledge-heavy tasks. Released October 27, 2026 (LFM3 release blog post) under the LFM Open License v1.0.
Training Data Pre-trained on 22T tokens total: web and synthetic data (~15T), then code, math, and science (3T at 4K context), mid-training on curated agentic data (3T at 32K context), plus 128K (500B tokens) and 256K (50B tokens) context extensions. Post-training in four stages: SFT (1.75T tokens), mixed RL across math/code/SQL/structured outputs, multi-domain on-policy distillation (MOPD) from six specialist RL teachers, and agentic RL in real agent harnesses.
Benchmark Scores
| Benchmark | Score | Date |
|---|---|---|
|
RULER 128K
long_context
|
100.00%
|
— |
|
Claw-Eval Avg
coding_agent
|
82.74%
|
— |
|
OmniScience Accuracy
knowledge
|
7.07
|
— |
|
LiveClaw
general_agent
|
45.60
|
— |
|
SciCode
|
42.80%
|
— |
|
WebArena-Verified
general_agent
|
30.67%
|
— |
|
SWE-bench Multilingual
coding_agent
|
21.30%
|
— |
|
MCP-Atlas
general_agent
|
26.07%
|
— |
|
Terminal Bench 2.1
coding_agent
|
13.88%
|
— |
|
Multi-IF
instruction_following
|
100.00%
|
— |
|
AutomationBench (Public)
general_agent
|
48.49%
|
— |
|
GPQA Diamond
stem_reasoning
|
41.52%
|
— |
|
OmniScience Non-Hallucination
knowledge
|
100.00%
|
— |
|
TAU3-Bench
general_agent
|
98.69%
|
— |
|
Ifstruct V1
instruction_following
|
96.35%
|
— |
|
BFCL-V4
general_agent
|
97.61%
|
— |
|
AA-Omniscience Index (public set)
knowledge
|
65.78%
|
— |
|
LiveCodeBench Pro 25Q2
stem_reasoning
|
100.00%
|
— |
|
IFBench
instruction_following
|
81.84%
|
— |
|
BrowseComp Plus
general_agent
|
18.60%
|
— |
|
HLE (with tools)
stem_reasoning
|
13.90
|
— |
|
Claw-Eval Pass^3
coding_agent
|
49.53%
|
— |
|
ToolSandbox
general_agent
|
80.36
|
— |
|
SWE-bench Verified (OpenCode)
coding_agent
|
43.40
|
— |
|
LiveCodeBench v6
stem_reasoning
|
72.66%
|
— |
|
AA-LCR
long_context
|
62.89%
|
— |
|
Humanity's Last Exam
stem_reasoning
|
9.60%
|
— |
|
EnterpriseOps-Gym
general_agent
|
28.20
|
— |
|
IFEval
instruction_following
|
99.85%
|
— |
Hardware Requirements
Estimated VRAM per quantization at 4,096 tokens context
| Quantization | Weights | KV Cache | Total VRAM |
|---|---|---|---|
| FP16 — 16-bit | 3.5 GB | 0.3 GB | 3.9 GB |
| INT8 — 8-bit | 1.7 GB | 0.1 GB | 2.0 GB |
| INT4 — 4-bit | 0.9 GB | 0.1 GB | 1.0 GB |
| FP4 — 4-bit | 0.9 GB | 0.1 GB | 1.0 GB |
Consumer GPUs that fit this model with a single card (INT4):
Architecture
- Attention
- Hybrid Attention (16:4)
- Layers
- 24
- Hidden size
- 2048
- Context
- 262K tokens
- Parameters
- 1730M
Source: Hugging Face config.json · Lfm3ForCausalLM · exact layer pattern · model repo
Training Pipeline
-
1
pretraining
Main pre-training
First of two pre-training stages that build LFM3-1.7B-Base on 22T tokens in total. Compared with LFM2, the data mix adds more scientific papers, repository-level code, math, and a wider range of knowledge sources. The pre-training recipe diagram shows this stage running on web and synthetic data (about 15T tokens), then on code, math, and science (3T tokens at 4K context).
-
2
cpt
Mid-training
Continued pre-training on the last 3.5T tokens uses curated, higher-quality data with a larger share of agentic traces and tool calls, and extends the context window to 256K tokens. The recipe diagram breaks this stage into mid-training on curated agentic data (3T tokens at 32K context), a 128K-token context extension (500B tokens), and a final 256K-token extension (50B tokens).
-
3
sft
Supervised fine-tuning (SFT)
Supervised fine-tuning on 1.75T tokens across various tasks, including chat, reasoning, tool calling, and agentic traces. First of the four post-training stages that develop conversation, reasoning, and tool-use capabilities.
-
4
rl
Mixed reinforcement learning
Reinforcement learning with many domains trained at once, from math and code to SQL and structured outputs. A length penalty in the reward keeps answers concise. The post-training recipe diagram shows the specialist RL teachers later start from this mixed RL checkpoint.
-
5
other
Multi-domain on-policy distillation (MOPD)
Six specialist RL teachers (code, math, tool use, long context, agentic work, and enterprise workflows), starting from the mixed RL checkpoint, are distilled back into a single student model. This returns the specialists' capabilities to the student before the final agentic RL stage.
-
6
rl
Agentic RL
Final post-training stage: tasks from web browsing to office work are run inside real agent harnesses, preparing the model for deployment. The card notes the model is post-trained for agentic harnesses such as Hermes Agent, Pi, and OpenClaw.
Linked Resources
Introducing LFM3: Every Modality for Specialized Intelligence
https://www.liquid.ai/blog/lfm3
Build specialized multimodal models with LFM3
https://huggingface.co/blog/LiquidAI/lfm3
Liquid AI Playground
https://playground.liquid.ai/
Liquid AI Console (API)
https://console.liquid.ai/dashboard
LFM3 collection
https://huggingface.co/collections/LiquidAI/lfm3
LFM Docs: Getting Started
https://docs.liquid.ai/lfm/getting-started/welcome
vLLM deployment docs
https://docs.liquid.ai/deployment/gpu-inference/vllm
SGLang deployment docs
https://docs.liquid.ai/deployment/gpu-inference/sglang
Transformers deployment docs
https://docs.liquid.ai/deployment/gpu-inference/transformers
llama.cpp deployment docs
https://docs.liquid.ai/deployment/on-device/llama-cpp
Ollama deployment docs
https://docs.liquid.ai/deployment/on-device/ollama
LM Studio deployment docs
https://docs.liquid.ai/deployment/on-device/lm-studio
MLX deployment docs
https://docs.liquid.ai/deployment/on-device/mlx
ONNX Runtime deployment docs
https://docs.liquid.ai/deployment/on-device/onnx
Agent Harnesses guide
https://docs.liquid.ai/examples/agent-harnesses
Deferred tools and tool search
https://docs.liquid.ai/lfm/key-concepts/tool-use
TRL fine-tuning guide
https://docs.liquid.ai/lfm/fine-tuning/trl
Liquid4All/cookbook (SFT with TRL notebook)
https://colab.research.google.com/github/Liquid4All/cookbook/blob/main/finetuning/notebooks/lfm3_sft_with_trl.ipynb
Liquid4All/cookbook (DPO with TRL notebook)
https://colab.research.google.com/github/Liquid4All/cookbook/blob/main/finetuning/notebooks/lfm3_dpo_with_trl.ipynb
Liquid4All/cookbook (GRPO with TRL notebook)
https://colab.research.google.com/github/Liquid4All/cookbook/blob/main/finetuning/notebooks/lfm3_grpo_with_trl.ipynb
Liquid4All/cookbook (CPT with TRL notebook)
https://colab.research.google.com/github/Liquid4All/cookbook/blob/main/finetuning/notebooks/lfm3_cpt_with_trl.ipynb
Citation (BibTeX)
https://huggingface.co/LiquidAI/LFM3-1.7B
No comments yet
Be the first to share your thoughts!