Instructions to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="ReadyArt/gemma-4-31B-it-scotoma-GGUF") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("ReadyArt/gemma-4-31B-it-scotoma-GGUF", device_map="auto") - llama-cpp-python
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="ReadyArt/gemma-4-31B-it-scotoma-GGUF", filename="gemma-4-31B-scotoma-IQ3_M.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 ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M
Use Docker
docker model run hf.co/ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ReadyArt/gemma-4-31B-it-scotoma-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": "ReadyArt/gemma-4-31B-it-scotoma-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M
- SGLang
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "ReadyArt/gemma-4-31B-it-scotoma-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ReadyArt/gemma-4-31B-it-scotoma-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "ReadyArt/gemma-4-31B-it-scotoma-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ReadyArt/gemma-4-31B-it-scotoma-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with Ollama:
ollama run hf.co/ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M
- Unsloth Studio
How to use ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for ReadyArt/gemma-4-31B-it-scotoma-GGUF to start chatting
- Pi
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf ReadyArt/gemma-4-31B-it-scotoma-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": "ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf ReadyArt/gemma-4-31B-it-scotoma-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 "ReadyArt/gemma-4-31B-it-scotoma-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 ReadyArt/gemma-4-31B-it-scotoma-GGUF with Docker Model Runner:
docker model run hf.co/ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M
- Lemonade
How to use ReadyArt/gemma-4-31B-it-scotoma-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull ReadyArt/gemma-4-31B-it-scotoma-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.gemma-4-31B-it-scotoma-GGUF-Q4_K_M
List all available models
lemonade list

Scotoma
A bounded blind spot for hesitation.
Findings / what it does
scotoma loosens gemmaโ4โ31Bโitโs cautious reflex. In practice, it produces output thatโs more varied, direct, and creative, with less of the base modelโs hedging and assistant persona stiffness.
It is not uncensored. The edit removed a bounded region while leaving the rest of the field intact. A blind spot, not blindness.
Etiology / how it was made
Most abliteration ablates the whole refusal direction. This process rescales computation the model needs, and you pay for it in intelligence and coherence. scotoma takes a narrower cut:
- Locate refusal. A heretic abliteration edit fit over attention + MLP.
- Project through a Jacobian lens. Keep only the component the lens reads as behavioral (what the model says) and discard the larger share thatโs critical for how it computes, the part crude abliteration rescales and damages. For scotoma that keeps ~22% of the abliteration's magnitude.
- Merge at 1.5ร. The projected edit was baked into bf16 weights at an application strength tuned by hand for feel.
The result applies the behavioral effect while sparing the machinery underneath, producing a model that is loosened, not lobotomized.
This is a research artifact, not a product. Behaviour varies with prompt and context, and the edit is a partial application by design; expect a model that gives more, not one that gives everything.
Contraindications / responsible use
scotoma refuses basically as much as its base model. You are responsible for what you generate and how itโs used.
Provenance
base โ gemma-4-31B-it ยท ยฉ Google, under the model license
edit โ heretic ยท ARA / mmd-rbf abliteration (trial-127)
lens โ Jacobian-lens projection ยท k=256 ยท 160-prompt fit
merge โ additive, bf16, scaling 1.5, layers 7โ41
- Downloads last month
- 1,721
3-bit
4-bit
5-bit
6-bit
8-bit