Instructions to use majentik/gemma-4-31B-it-RotorQuant with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use majentik/gemma-4-31B-it-RotorQuant with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("image-text-to-text", model="majentik/gemma-4-31B-it-RotorQuant")

# Load model directly
from transformers import AutoModel
model = AutoModel.from_pretrained("majentik/gemma-4-31B-it-RotorQuant", dtype="auto")

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use majentik/gemma-4-31B-it-RotorQuant with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "majentik/gemma-4-31B-it-RotorQuant"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "majentik/gemma-4-31B-it-RotorQuant",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

Use Docker

docker model run hf.co/majentik/gemma-4-31B-it-RotorQuant

SGLang

How to use majentik/gemma-4-31B-it-RotorQuant 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 "majentik/gemma-4-31B-it-RotorQuant" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "majentik/gemma-4-31B-it-RotorQuant",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

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 "majentik/gemma-4-31B-it-RotorQuant" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "majentik/gemma-4-31B-it-RotorQuant",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

Docker Model Runner
How to use majentik/gemma-4-31B-it-RotorQuant with Docker Model Runner:
```
docker model run hf.co/majentik/gemma-4-31B-it-RotorQuant
```

majentik commited on 27 days ago

Commit

35cdfbf

verified ·

1 Parent(s): 1ecf101

docs: Tier 2 polish — variant matrix + quant trade-off

Browse files

Files changed (1) hide show

README.md +25 -0

README.md CHANGED Viewed

@@ -141,3 +141,28 @@ If you want combined weight + KV cache compression, majentik hosts pre-quantized
 - [llama-cpp-turboquant fork](https://github.com/johndpope/llama-cpp-turboquant/tree/feature/planarquant-kv-cache)
 - [Base model: google/gemma-4-31B-it](https://huggingface.co/google/gemma-4-31B-it)
 - [gemma-4-31B-it announcement](https://blog.google/technology/developers/gemma-4/)

 - [llama-cpp-turboquant fork](https://github.com/johndpope/llama-cpp-turboquant/tree/feature/planarquant-kv-cache)
 - [Base model: google/gemma-4-31B-it](https://huggingface.co/google/gemma-4-31B-it)
 - [gemma-4-31B-it announcement](https://blog.google/technology/developers/gemma-4/)
+## Variants in this family
+(Showing 18 sibling variants under `majentik/gemma4-31b-it-*`. The current variant — `RotorQuant` — is **bolded**.)
+| Variant | Runtime | Approx size | Use case |
+|---|---|---|---|
+| **RotorQuant** | runtime modifier | n/a | KV-cache root (weight-agnostic) |
+| [RotorQuant-AWQ-4bit](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-awq-4bit) | transformers | ~19 GB | GPU 4-bit (AutoAWQ) |
+| [RotorQuant-AWQ-8bit](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-awq-8bit) | transformers | ~34 GB | GPU 8-bit (AutoAWQ) |
+| [RotorQuant-GGUF-IQ4_XS](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-gguf-IQ4_XS) | llama.cpp | ~27 GB | Lossy 4-bit, low-RAM CPU/edge |
+| [RotorQuant-GGUF-Q2_K](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-gguf-Q2_K) | llama.cpp | ~19 GB | Lossy, low-RAM CPU/edge |
+| [RotorQuant-GGUF-Q3_K_M](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-gguf-Q3_K_M) | llama.cpp | ~24 GB | Smaller 3-bit, CPU-friendly |
+| [RotorQuant-GGUF-Q4_K_M](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-gguf-Q4_K_M) | llama.cpp | ~34 GB | Balanced default |
+| [RotorQuant-GGUF-Q5_K_M](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-gguf-Q5_K_M) | llama.cpp | ~41 GB | Higher fidelity, more RAM |
+| [RotorQuant-GGUF-Q8_0](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-gguf-Q8_0) | llama.cpp | ~65 GB | Near-lossless reference |
+| [RotorQuant-MLX-2bit](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-mlx-2bit) | mlx-lm | ~9.9 GB | Apple Silicon, smallest |
+| [RotorQuant-MLX-4bit](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-mlx-4bit) | mlx-lm | ~19 GB | Apple Silicon balanced |
+| [RotorQuant-MLX-8bit](https://huggingface.co/majentik/gemma4-31b-it-rotorquant-mlx-8bit) | mlx-lm | ~37 GB | Apple Silicon reference |
+| [TurboQuant](https://huggingface.co/majentik/gemma4-31b-it-turboquant) | runtime modifier | n/a | KV-cache root (weight-agnostic) |
+| [TurboQuant-AWQ-4bit](https://huggingface.co/majentik/gemma4-31b-it-turboquant-awq-4bit) | transformers | ~19 GB | GPU 4-bit (AutoAWQ) |
+| [TurboQuant-AWQ-8bit](https://huggingface.co/majentik/gemma4-31b-it-turboquant-awq-8bit) | transformers | ~34 GB | GPU 8-bit (AutoAWQ) |
+| [TurboQuant-MLX-2bit](https://huggingface.co/majentik/gemma4-31b-it-turboquant-mlx-2bit) | mlx-lm | ~9.9 GB | Apple Silicon, smallest |
+| [TurboQuant-MLX-4bit](https://huggingface.co/majentik/gemma4-31b-it-turboquant-mlx-4bit) | mlx-lm | ~19 GB | Apple Silicon balanced |
+| [TurboQuant-MLX-8bit](https://huggingface.co/majentik/gemma4-31b-it-turboquant-mlx-8bit) | mlx-lm | ~37 GB | Apple Silicon reference |