Instructions to use CelesteImperia/Gemma-4-26B-MoE-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use CelesteImperia/Gemma-4-26B-MoE-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="CelesteImperia/Gemma-4-26B-MoE-GGUF", filename="Gemma-4-26B-MoE-IQ3_M.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use CelesteImperia/Gemma-4-26B-MoE-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M # Run inference directly in the terminal: llama-cli -hf CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M # Run inference directly in the terminal: llama-cli -hf CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_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 CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M # Run inference directly in the terminal: ./llama-cli -hf CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_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 CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M
Use Docker
docker model run hf.co/CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M
- LM Studio
- Jan
- Ollama
How to use CelesteImperia/Gemma-4-26B-MoE-GGUF with Ollama:
ollama run hf.co/CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M
- Unsloth Studio
How to use CelesteImperia/Gemma-4-26B-MoE-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 CelesteImperia/Gemma-4-26B-MoE-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 CelesteImperia/Gemma-4-26B-MoE-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for CelesteImperia/Gemma-4-26B-MoE-GGUF to start chatting
- Pi
How to use CelesteImperia/Gemma-4-26B-MoE-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_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": "CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use CelesteImperia/Gemma-4-26B-MoE-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 CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_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 CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M
Run Hermes
hermes
- Docker Model Runner
How to use CelesteImperia/Gemma-4-26B-MoE-GGUF with Docker Model Runner:
docker model run hf.co/CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M
- Lemonade
How to use CelesteImperia/Gemma-4-26B-MoE-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull CelesteImperia/Gemma-4-26B-MoE-GGUF:IQ3_M
Run and chat with the model
lemonade run user.Gemma-4-26B-MoE-GGUF-IQ3_M
List all available models
lemonade list
Celeste-Gemma-4-26B-MoE-Platinum-GGUF (Platinum Series)
Welcome to the Platinum Series release of Gemma-4-26B-MoE. To combat the inherent fragility of 128-expert architectures during compression, every variant in this collection was forged with a custom Importance Matrix (i-matrix). By shielding the critical gating weights, we’ve ensured that expert routing remains precise and intelligence stays intact, even at lower bit-rates.
High-fidelity GGUF weights for Gemma 4 (26B MoE / A4B).
🛠️ Technical Specifications
| Feature | Specification |
|---|---|
| Total Parameters | 25.23 Billion |
| Active Parameters | ~3.8 Billion (per token) |
| Expert Count | 128 Experts (8 active per token) |
| Quantization | i-Matrix Protected (Q3 - Q8 Variants) |
| Context Window | 128,000 Tokens |
| Position Embeddings | p-RoPE (Proportional Rotary) |
🌟 Key Features
- Architecture: Gemma 4 Mixture-of-Experts (A4B).
- Expert Precision: Custom Importance Matrix (i-matrix) calibrated on wikitext-2 with 94-99% expert activation coverage to ensure zero routing-gate collapse.
- Context Stability: Native support for Proportional RoPE scaling for ultra-long context window retention.
- Workstation Optimized: Manually forged on a dual-GPU NVIDIA RTX 3090 + A4000 setup to ensure production-grade reliability and 24GB VRAM compatibility.
This repository contains the Platinum Series universal GGUF release of Gemma-4-26B-MoE. MoE models with high expert counts are fragile; these quants use an i-matrix to shield the critical routing pathways. This ensures that even at lower bit-rates, the model maintains the reasoning depth of the 26B engine while operating with the speed of a 4B parameter model.
📦 Available Files & Quantization Details
| File | Method | Description |
|---|---|---|
| IQ3_M | i-matrix | Efficiency King. Smallest viable size for high-speed mobile/NPU deployment. |
| Q4_K_M | k-quant | Balanced Standard. Recommended for most general-purpose logic tasks. |
| IQ4_XS | i-matrix | The MoE Gold Standard. (~15.8 GB) Optimized for the RTX 3090 with expert protection. |
| Q5_K_M | k-quant | Platinum Tier. High-fidelity reasoning with minimal perplexity loss. |
| Q6_K | k-quant | Near-lossless expert routing for complex document analysis. |
| Q8_0 | block-quant | Reference Grade. Maximum fidelity to the BF16 master weights. |
🛠️ Usage (llama-cli)
To utilize the 128-expert routing and p-RoPE scaling, use the latest build of llama.cpp :
./llama-cli -m Gemma-4-26B-MoE-IQ4_XS.gguf -n 512 --flash-attn --ctx-size 8192 -ngl 99
🐍 Python Inference (llama-cpp-python)
To run these engines using the provided python script :
from llama_cpp import Llama
# Optimized for 24GB VRAM (RTX 3090)
llm = Llama(
model_path="./Gemma-4-26B-MoE-IQ4_XS.gguf",
n_gpu_layers=-1, # Offload 128 experts to VRAM
n_ctx=16384, # High-speed context window
use_mlock=True # Pin memory for expert routing stability
)
output = llm(
"<|turn|>user\nAnalyze the structural efficiency of 128-experts in this MoE model.<|turn|>model\n",
max_tokens=1024,
stop=["<turn|>", "<|file_separator|>"]
)
print(output['choices'][0]['text'])
💻 For C# / .NET Users (LLamaSharp)
Fully compatible with .NET applications via the csharp script and the LLamaSharp library.
using LLama.Common;
using LLama;
var parameters = new ModelParams("Gemma-4-26B-MoE-IQ4_XS.gguf")
{
ContextSize = 16384,
GpuLayerCount = -1, // Distribute experts across RTX 3090 + A4000
TensorSplit = { 1.5f, 1.0f } // Balanced split for dual-GPU Noida Forge setup
};
using var weights = LLamaWeights.LoadFromFile(parameters);
using var context = weights.CreateContext(parameters);
var executor = new InteractiveExecutor(context);
var chatHistory = new ChatHistory();
chatHistory.AddMessage(AuthorRole.System, "You are a helpful assistant.");
var session = new ChatSession(executor, chatHistory);
await foreach (var text in session.ChatAsync(new ChatHistory.Message(AuthorRole.User, "Validate the architectural integrity of this project."), new InferenceParams { MaxTokens = 2048 }))
{
Console.Write(text);
}
🏗️ Hardware Requirements
- RTX 3090 / 4090: Recommended for full offloading of Q4_K_M through Q6_K variants.
- System RAM: 32GB+ for model loading and initial calibration.
- Storage: ~55GB required for the full GGUF collection.
☕ Support the Forge
Maintaining the production line for high-fidelity 128-expert models requires significant hardware resources. If these tools power your research, please consider supporting the development:
| Platform | Support Link |
|---|---|
| Global & India | Support via Razorpay |
Scan to support via UPI (India Only):
Connect with the architect: Abhishek Jaiswal on LinkedIn
- Downloads last month
- 1,492
3-bit
4-bit
5-bit
6-bit
8-bit
ollama run hf.co/CelesteImperia/Gemma-4-26B-MoE-GGUF: