Skip to content

fix review findings and additional clean up#116

Open
iamleonie wants to merge 1 commit into
mainfrom
lm/review-findings-guides
Open

fix review findings and additional clean up#116
iamleonie wants to merge 1 commit into
mainfrom
lm/review-findings-guides

Conversation

@iamleonie

Copy link
Copy Markdown
Contributor
  • Addressed post-merge review feedback on the migration guide.
  • Simplified runtime guidance into GPU inference and edge/on-device deployment links. (Didn't contain much migration specific details)
  • Reworked migration guide sections for clearer navigation: Deployment runtimes, Chat Template, Sampling Configuration, Tool Use, and Fine-tuning.
  • Added section-level links from the intro and moved main documentation references to the bottom of each section.
  • Clarified sampling guidance and linked to the Prompting Guide for per-model recommendations.
  • Standardized tool-use guidance around the lfm2 parser and native Pythonic tool-call format. (confirmed its called lfm2 parser
  • Added reusable snippets for shared ChatML and tool-call examples.
  • Removed duplicated fine-tuning stack details and linked to the canonical fine-tuning docs.

@mintlify

mintlify Bot commented Jul 10, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
liquid-docs 🟢 Ready View Preview Jul 10, 2026, 3:38 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

import { ChatMLExample } from "/snippets/key-concepts/chatml-example.mdx";
import { ToolCallTokenExample } from "/snippets/key-concepts/tool-call-token-example.mdx";

This guide is for teams already running Qwen, Llama, or Gemma who want to evaluate Liquid Foundation Models (LFMs) as replacements. LFMs load and serve through the same frameworks you already use, so most migrations are a model ID and configuration change. The details that usually matter are deployment runtime choice (see [Deployment runtimes](#deployment-runtimes)), chat templates (see [Chat Template](#chat-template)), sampling configuration (see [Sampling Configuration](#sampling-configuration)), tool-call parsing (see [Tool Use](#tool-use)), and LoRA module names (see [Fine-tuning](#fine-tuning)).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could be split into two paragraphs or a bullet list

| Qwen3 thinking mode or DeepSeek distills | [LFM2.5-1.2B-Thinking](https://huggingface.co/LiquidAI/LFM2.5-1.2B-Thinking) | Reasoning traces at 1.2B. |
| Qwen3-0.6B, Llama-3.2-1B, Gemma-3-270M/1B | [LFM2.5-230M](https://huggingface.co/LiquidAI/LFM2.5-230M) or [LFM2.5-350M](https://huggingface.co/LiquidAI/LFM2.5-350M) | Smallest text models for classification, extraction, routing, and tight memory budgets. |
| Qwen3-1.7B, Llama-3.2-3B, Gemma-3-4B, reasoning models in this latency class | [LFM2.5-1.2B-Instruct](https://huggingface.co/LiquidAI/LFM2.5-1.2B-Instruct) or [LFM2.5-1.2B-Thinking](https://huggingface.co/LiquidAI/LFM2.5-1.2B-Thinking) | Choose the Thinking variant when reasoning quality is worth the added latency. |
| Qwen3-4B/8B, Llama-3.1-8B, Gemma-3-12B | [LFM2-2.6B](https://huggingface.co/LiquidAI/LFM2-2.6B) or [LFM2.5-8B-A1B](https://huggingface.co/LiquidAI/LFM2.5-8B-A1B) | Compare in your latency and memory budget; 8B-A1B is an MoE model with 1.5B active parameters. |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok actually LFM2-2.6B is not something we should advertise because it's from the previous generation (the 8B-A1B will be better here), my bad!

| Qwen3-4B/8B, Llama-3.1-8B, Gemma-3-12B | [LFM2.5-8B-A1B](https://huggingface.co/LiquidAI/LFM2.5-8B-A1B) | MoE with 8B total and 1.5B active parameters. |
| Qwen3-14B/32B and larger dense models | [LFM2-24B-A2B](https://huggingface.co/LiquidAI/LFM2-24B-A2B) | 24B total and roughly 2.3B active parameters. |
| Qwen3 thinking mode or DeepSeek distills | [LFM2.5-1.2B-Thinking](https://huggingface.co/LiquidAI/LFM2.5-1.2B-Thinking) | Reasoning traces at 1.2B. |
| Qwen3-0.6B, Llama-3.2-1B, Gemma-3-270M/1B | [LFM2.5-230M](https://huggingface.co/LiquidAI/LFM2.5-230M) or [LFM2.5-350M](https://huggingface.co/LiquidAI/LFM2.5-350M) | Smallest text models for classification, extraction, routing, and tight memory budgets. |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I noticed that we're talking about Qwen3 and Gemma 3 instead of Qwen3.5 and Gemma 4 everywhere. We should probably either update it when there's a clear replacement or have both when there's none (particularly true for Gemma 4).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants