Instructions to use Lufel6848/LFM2.5-2.6B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use Lufel6848/LFM2.5-2.6B-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use Lufel6848/LFM2.5-2.6B-GGUF with Ollama:
ollama run hf.co/Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
- Unsloth Studio
How to use Lufel6848/LFM2.5-2.6B-GGUF with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Lufel6848/LFM2.5-2.6B-GGUF to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Lufel6848/LFM2.5-2.6B-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Lufel6848/LFM2.5-2.6B-GGUF to start chatting
- Pi
How to use Lufel6848/LFM2.5-2.6B-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use Lufel6848/LFM2.5-2.6B-GGUF with Docker Model Runner:
docker model run hf.co/Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
- Lemonade
How to use Lufel6848/LFM2.5-2.6B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.LFM2.5-2.6B-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use Lufel6848/LFM2.5-2.6B-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
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 Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use Lufel6848/LFM2.5-2.6B-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "Lufel6848/LFM2.5-2.6B-GGUF:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
LFM2.5-2.6B GGUF
Community-made GGUF conversions and quantizations of LFM2.5-2.6B, intended for local inference with GGUF-compatible software.
The original model was converted from its Hugging Face / SafeTensors distribution to GGUF using tools provided by llama.cpp.
This is an unofficial community conversion.
The LFM2.5-2.6B model, architecture, and original weights were developed and released by Liquid AI. This repository provides converted and quantized GGUF files derived from the original model.
Original Model
- Model:
LiquidAI/LFM2.5-2.6B - Developer: Liquid AI
- Original format: SafeTensors
- License: Apache License 2.0
- Original model: https://huggingface.co/LiquidAI/LFM2.5-2.6B
Refer to the original model repository for the authoritative model card, capabilities, limitations, usage information, and license terms.
Available GGUF Files
This repository provides the original BF16 GGUF conversion alongside several quantized variants:
| Format / Quantization | Description |
|---|---|
BF16 |
GGUF conversion retaining BF16 weight precision. Largest file and highest memory requirement among the provided variants. |
Q4_K_M |
Lower storage and memory requirements. Suitable as a general-purpose local inference option. |
Q5_K_M |
Balanced option with additional weight precision compared with Q4_K_M. |
Q6_K |
Higher-precision quantization for systems with more available memory. |
Q8_0 |
High-precision quantization with substantially larger memory and storage requirements. |
Actual memory consumption may be higher than the GGUF file size and depends on factors such as context length, KV cache configuration, inference backend, GPU offloading, and runtime settings.
Conversion Pipeline
The files in this repository were produced using a workflow based on llama.cpp:
LFM2.5-2.6B
โ
โ SafeTensors
โผ
convert_hf_to_gguf.py
โ
โผ
BF16 GGUF
โ
โ llama-quantize
โผ
โโโโโโโโโโฌโโโโโโโโโฌโโโโโโโโฌโโโโโโโ
โQ4_K_M โQ5_K_M โ Q6_K โ Q8_0 โ
โโโโโโโโโโดโโโโโโโโโดโโโโโโโโดโโโโโโโ
No additional training or fine-tuning is performed as part of this conversion process.
Quantization changes the numerical representation of the model weights to reduce storage and memory requirements and may affect model quality.
Usage
These GGUF files are intended for applications and inference engines with compatible GGUF support, particularly llama.cpp and software built around it.
Example with llama.cpp:
llama-cli \
-m LFM2.5-2.6B-Q5_K_M.gguf \
-p "Explain how GGUF quantization works."
Runtime parameters should be adjusted according to your hardware, available memory, desired context length, and inference backend.
Compatibility
GGUF compatibility depends on the version of llama.cpp and its support for the underlying LFM architecture.
Because both llama.cpp and GGUF continue to evolve, older inference engines may not correctly load files produced by newer versions.
If you encounter GGUF compatibility problems, first test with a recent version of llama.cpp or your preferred GGUF-compatible runtime.
Reproducibility
The conversion process follows the standard Hugging Face / SafeTensors โ GGUF workflow provided by llama.cpp.
The general process consists of:
- obtaining the original
LiquidAI/LFM2.5-2.6BSafeTensors model; - converting the model to GGUF using
convert_hf_to_gguf.py; - retaining the resulting BF16 GGUF;
- quantizing the BF16 GGUF using
llama-quantize; - producing the
Q4_K_M,Q5_K_M,Q6_K, andQ8_0variants.
Conversion and quantization behavior may vary between llama.cpp revisions as model architecture support and GGUF tooling evolve.
Credits
Liquid AI
The original LFM2.5-2.6B model, architecture, and model weights were developed and released by Liquid AI.
This repository would not exist without their work and release of the original model.
- Liquid AI: https://www.liquid.ai/
- Original model: https://huggingface.co/LiquidAI/LFM2.5-2.6B
All credit for the original model belongs to its respective authors and contributors.
llama.cpp
GGUF conversion and quantization are performed using tools from the open-source llama.cpp project.
This workflow relies on tooling including:
convert_hf_to_gguf.pyllama-quantize- GGUF infrastructure provided by the project
Project:
https://github.com/ggml-org/llama.cpp
Credit belongs to the llama.cpp maintainers and contributors for the conversion, quantization, GGUF, and local inference tooling used by this workflow.
License
The original LFM2.5-2.6B model is distributed under the Apache License 2.0.
These files are converted and quantized derivatives of the original model weights and retain the applicable licensing terms of the original model.
Please review the original LFM2.5-2.6B repository and its license before using or redistributing these files.
Disclaimer
This repository is an unofficial community conversion and is not affiliated with, endorsed by, or maintained by Liquid AI, Vast.ai, or the llama.cpp project.
Vast.ai was used as the environment in which the conversion workflow was tested. Its use does not imply affiliation, endorsement, or a technical requirement to use Vast.ai.
The purpose of this repository is to provide GGUF variants of the original openly released model for local inference while documenting and crediting the upstream projects used to create them.
- Downloads last month
- 336
4-bit
5-bit
6-bit
8-bit
16-bit