Instructions to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="ShahzebKhoso/LFM2.5-8B-A1B-GGUF", filename="LFM2.5-8B-A1B-FP16.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf ShahzebKhoso/LFM2.5-8B-A1B-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 ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf ShahzebKhoso/LFM2.5-8B-A1B-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 ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ShahzebKhoso/LFM2.5-8B-A1B-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ShahzebKhoso/LFM2.5-8B-A1B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
- Ollama
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with Ollama:
ollama run hf.co/ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
- Unsloth Studio
How to use ShahzebKhoso/LFM2.5-8B-A1B-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 ShahzebKhoso/LFM2.5-8B-A1B-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 ShahzebKhoso/LFM2.5-8B-A1B-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for ShahzebKhoso/LFM2.5-8B-A1B-GGUF to start chatting
- Pi
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf ShahzebKhoso/LFM2.5-8B-A1B-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 ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- Docker Model Runner
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with Docker Model Runner:
docker model run hf.co/ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
- Lemonade
How to use ShahzebKhoso/LFM2.5-8B-A1B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.LFM2.5-8B-A1B-GGUF-Q4_K_M
List all available models
lemonade list
LFM2.5-8B-A1B - GGUF Quantized Versions
This repository provides GGUF quantized versions of LiquidAI/LFM2.5-8B-A1B, converted with llama.cpp.
The purpose of this repository is to provide fast, easy-to-use local inference files for llama.cpp, Ollama, LM Studio, Jan, Open WebUI, and llama-cpp-python users.
Model Details
- Base model:
LiquidAI/LFM2.5-8B-A1B - Architecture: Transformer
- Format: GGUF
- Source license:
other - Conversion tool:
convert_hf_to_gguf.pyfrom llama.cpp - Quantization tool:
llama-quantize - Recommended file:
LFM2.5-8B-A1B-Q4_K_M.gguf
Quantized Files
| Quant | Filename | Size | SHA256 | Notes |
|---|---|---|---|---|
| FP16 | LFM2.5-8B-A1B-FP16.gguf |
~15.78 GiB | 2a6007558690... |
Full precision converted GGUF baseline |
| Q2_K | LFM2.5-8B-A1B-Q2_K.gguf |
~2.97 GiB | 8f23e224429e... |
Smallest, lowest quality |
| Q3_K_M | LFM2.5-8B-A1B-Q3_K_M.gguf |
~3.83 GiB | 5a79627fc67f... |
Small balanced version |
| Q4_0 | LFM2.5-8B-A1B-Q4_0.gguf |
~4.51 GiB | c0a1d6adfbaa... |
Simple 4-bit quantization |
| Q4_K_M | LFM2.5-8B-A1B-Q4_K_M.gguf |
~4.80 GiB | 96dd85418cff... |
Recommended default for most users |
| Q5_K_M | LFM2.5-8B-A1B-Q5_K_M.gguf |
~5.62 GiB | bfa79de6abb8... |
Better quality with moderate size |
| Q6_K | LFM2.5-8B-A1B-Q6_K.gguf |
~6.48 GiB | 12e71861dee1... |
High quality |
| Q8_0 | LFM2.5-8B-A1B-Q8_0.gguf |
~8.39 GiB | 6fb1629c19fd... |
Near FP16 quality |
Validation
Each file was tested with llama-cli for basic load + generation.
| Quant | Filename | Status |
|---|---|---|
| FP16 | LFM2.5-8B-A1B-FP16.gguf |
✅ passed |
| Q2_K | LFM2.5-8B-A1B-Q2_K.gguf |
✅ passed |
| Q3_K_M | LFM2.5-8B-A1B-Q3_K_M.gguf |
✅ passed |
| Q4_0 | LFM2.5-8B-A1B-Q4_0.gguf |
✅ passed |
| Q4_K_M | LFM2.5-8B-A1B-Q4_K_M.gguf |
✅ passed |
| Q5_K_M | LFM2.5-8B-A1B-Q5_K_M.gguf |
✅ passed |
| Q6_K | LFM2.5-8B-A1B-Q6_K.gguf |
✅ passed |
| Q8_0 | LFM2.5-8B-A1B-Q8_0.gguf |
✅ passed |
Usage
llama.cpp
llama-cli -m LFM2.5-8B-A1B-Q4_K_M.gguf -p "Hello! Introduce yourself briefly."
Older builds may use:
./main -m LFM2.5-8B-A1B-Q4_K_M.gguf -p "Hello! Introduce yourself briefly."
llama.cpp directly from Hugging Face
llama-cli -hf ShahzebKhoso/LFM2.5-8B-A1B-GGUF:Q4_K_M -p "Hello! Introduce yourself briefly."
llama-cpp-python
from huggingface_hub import hf_hub_download
from llama_cpp import Llama
model_path = hf_hub_download(
repo_id="ShahzebKhoso/LFM2.5-8B-A1B-GGUF",
filename="LFM2.5-8B-A1B-Q4_K_M.gguf",
)
llm = Llama(model_path=model_path)
out = llm.create_chat_completion(
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello! Introduce yourself briefly."},
],
max_tokens=128,
)
print(out["choices"][0]["message"]["content"])
Which file should I use?
- Use
Q4_K_Mfor the best default balance. - Use
Q5_K_Mfor better quality. - Use
Q8_0if you want near-original quality and have more memory. - Use
Q2_KorQ3_K_Monly when memory is very limited.
Provenance
This repository is a quantized derivative of:
LiquidAI/LFM2.5-8B-A1B
Base model metadata:
revision: 5492b17c7128ec966b5fc661e374ee7edba7423d
pipeline_tag: text-generation
tags: transformers, safetensors, lfm2_moe, text-generation, liquid, lfm2.5, edge, conversational, en, ar, zh, fr, de, ja, ko, es, pt, arxiv:2511.23404, base_model:LiquidAI/LFM2.5-8B-A1B-Base, base_model:finetune:LiquidAI/LFM2.5-8B-A1B-Base
- Downloads last month
- 352