Instructions to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF with Transformers:
# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M
Use Docker
docker model run hf.co/mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF with Ollama:
ollama run hf.co/mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M
- Unsloth Studio
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF to start chatting
- Pi
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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": "mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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 "mradermacher/gemma-4-26B-A4B-it-abliterix-i1-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"
- Docker Model Runner
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF with Docker Model Runner:
docker model run hf.co/mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M
- Lemonade
How to use mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull mradermacher/gemma-4-26B-A4B-it-abliterix-i1-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.gemma-4-26B-A4B-it-abliterix-i1-GGUF-Q4_K_M
List all available models
lemonade list
This might just be The One!
Every other uncensored model of Gemma 4-26B-A4B I've tried so far has a problem where it will sometimes output a single token and then hang. I end up needing to stop the hung response, and edit my prompt slightly, and sometimes even then it continues to hang. The only surefire workaround is to attach an image (I created a little black PNG just for the purpose) which seems to dislodge the log jam. I could not find anyone else talking about this, so I have been left to my own devices to figure out the nature of the problem.
Then earlier tonight, I was trying to get Gemma 4-31B to perform to a reasonable speed. I completely failed, but along the way that model said something about MoE models sometimes activating the wrong neurons and outputting a single token and then seizing up—exactly the behavior I've been getting from every single uncensored 26B model. I abandoned the attempt to make 31B performant enough to be tolerable, and decided to make one more check of Hugging Face to see if just maybe someone else was talking about my problem. That's when I found this model, last updated ONE MINUTE (!) prior to my check. I looked at the model card describing how this one is different and decided to give it a shot.
So far, it's actually working! I've had a couple of glitches in the output that I can attribute to using the IQ3_M quantization, but it hasn't hung on me even once! This one just might have the magic sauce. And the model card explaining how the abliteration process was done differently is a very enlightening read, I highly recommend giving it a look.
I also grabbed the i1-Q5_K_M quantization to hopefully avoid those occasional moments of derp from IQ3_M, figuring I'll have a "fast model" and a "smart model" and switch between them as necessary. The speed penalty of the larger version is only about 25% too, running on my potato of an office PC with an RTX 3060 (12 GB).
These are the parameters I'm using with IQ3_M:
[Path]\llama-server.exe ^
--model "[Path]\gemma-4-26B-A4B-it-abliterix.i1-IQ3_M.gguf" ^
--mmproj "[Path]\gemma-4-26B-A4B-it.mmproj-Q8_0.gguf" ^
--image-max-tokens 1120 ^
--chat-template-file "[Path]\chat_template.jinja" ^
--ctx-size 131072 ^
--n-cpu-moe 9 ^
--cache-type-k iq4_nl ^
--cache-type-v iq4_nl ^
--reasoning-budget 2048 ^
--reasoning-budget-message "Reasoning budget exceeded (looping?)" ^
--log-timestamps
And with i1-Q5_K_M:
[Path]\llama-server.exe ^
--model "[Path]\gemma-4-26B-A4B-it-abliterix.i1-Q5_K_M.gguf" ^
--mmproj "[Path]\gemma-4-26B-A4B-it.mmproj-Q8_0.gguf" ^
--image-max-tokens 1120 ^
--chat-template-file "[Path]\chat_template.jinja" ^
--ctx-size 131072 ^
--n-cpu-moe 18 ^
--cache-type-k q5_1 ^
--cache-type-v q5_1 ^
--reasoning-budget 2048 ^
--reasoning-budget-message "Reasoning budget exceeded (looping?)" ^
--log-timestamps
You may be able to figure out that I'm running Windows, which uses ^ as the "don't break the line" character. Obviously, substitute whatever your OS uses if it's different.
EDIT: Apparently the model's structure has changed sufficiently that the .mmproj file for the "normal" Gemma 4 26B-A4B no longer works. The model now crashes when presented with vision tasks. No replacement .mmproj file has been provided. So much for my attempt to Agentify this model!
EDIT: Apparently the model's structure has changed sufficiently that the .mmproj file for the "normal" Gemma 4 26B-A4B no longer works. The model now crashes when presented with vision tasks. No replacement .mmproj file has been provided. So much for my attempt to Agentify this model!
The reason none was provided almost certainly is because the mmproj extraction failed. We always provide the mmproj file if mmproj extraction is possible.
Preliminary testing with https://huggingface.co/mradermacher/gemma-4-26B-A4B-it-heretic-ara-v2-GGUF/tree/main is looking good for me in LM Studio, if you can’t wait for the author to produce his MMPROJ files.
Preliminary testing with https://huggingface.co/mradermacher/gemma-4-26B-A4B-it-heretic-ara-v2-GGUF/tree/main is looking good for me in LM Studio, if you can’t wait for the author to produce his MMPROJ files.
Alas, I get 1-token hangs with that model with unmanageable frequency—just like every other uncensored 26B model except Abliterix. That's why I'm so excited about this model, it fixes the single largest problem I've been having although the side effect is that it is no longer compatible with the mmproj file.
It's worth a shot. But I left an inquiry on wangzhang's own project page about it and got the response "will do it later". Hopefully this means they understand that Abliterix is no longer just a proof of concept, some people (or at least me) are actually adopting it as their primary uncensored local model.
EDIT: Unlike the "stock" model, llama-server did not crash and the image seems to have been mostly seen correctly. Some salient details have been missed, but that may just be normal behavior as I've noticed the vision tends to be kind of "hit and miss". Thank you for the suggestion, I'll experiment more tomorrow.
I just had llama-server completely crash due to an image using the Abliterix model and the Heretic-ARA mmproj. They might play nice together some of the time, but I found an image that completely breaks things: it was a Corvette and a Silverado in a collision where the Corvette acted like a wedge and the Silverado landed half on top of it. Fortunately, this happened in Australia, so the Corvette driver was on the side that didn't get crushed.