Text Generation
Transformers
Safetensors
GGUF
English
multilingual
gemma4_text
gemma
gemma-4
classification
text-only
vram-optimized
ollama
conversational
Instructions to use igorls/gemma4-e4b-classifier with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use igorls/gemma4-e4b-classifier with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="igorls/gemma4-e4b-classifier") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("igorls/gemma4-e4b-classifier") model = AutoModelForCausalLM.from_pretrained("igorls/gemma4-e4b-classifier") messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - llama-cpp-python
How to use igorls/gemma4-e4b-classifier with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="igorls/gemma4-e4b-classifier", filename="gemma4-e4b-classifier-Q4_K_M.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use igorls/gemma4-e4b-classifier with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf igorls/gemma4-e4b-classifier:Q4_K_M # Run inference directly in the terminal: llama-cli -hf igorls/gemma4-e4b-classifier:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf igorls/gemma4-e4b-classifier:Q4_K_M # Run inference directly in the terminal: llama-cli -hf igorls/gemma4-e4b-classifier: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 igorls/gemma4-e4b-classifier:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf igorls/gemma4-e4b-classifier: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 igorls/gemma4-e4b-classifier:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf igorls/gemma4-e4b-classifier:Q4_K_M
Use Docker
docker model run hf.co/igorls/gemma4-e4b-classifier:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use igorls/gemma4-e4b-classifier with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "igorls/gemma4-e4b-classifier" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "igorls/gemma4-e4b-classifier", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/igorls/gemma4-e4b-classifier:Q4_K_M
- SGLang
How to use igorls/gemma4-e4b-classifier 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 "igorls/gemma4-e4b-classifier" \ --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": "igorls/gemma4-e4b-classifier", "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 "igorls/gemma4-e4b-classifier" \ --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": "igorls/gemma4-e4b-classifier", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use igorls/gemma4-e4b-classifier with Ollama:
ollama run hf.co/igorls/gemma4-e4b-classifier:Q4_K_M
- Unsloth Studio new
How to use igorls/gemma4-e4b-classifier 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 igorls/gemma4-e4b-classifier 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 igorls/gemma4-e4b-classifier to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for igorls/gemma4-e4b-classifier to start chatting
- Pi new
How to use igorls/gemma4-e4b-classifier with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf igorls/gemma4-e4b-classifier: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": "igorls/gemma4-e4b-classifier:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use igorls/gemma4-e4b-classifier with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf igorls/gemma4-e4b-classifier: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 igorls/gemma4-e4b-classifier:Q4_K_M
Run Hermes
hermes
- Docker Model Runner
How to use igorls/gemma4-e4b-classifier with Docker Model Runner:
docker model run hf.co/igorls/gemma4-e4b-classifier:Q4_K_M
- Lemonade
How to use igorls/gemma4-e4b-classifier with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull igorls/gemma4-e4b-classifier:Q4_K_M
Run and chat with the model
lemonade run user.gemma4-e4b-classifier-Q4_K_M
List all available models
lemonade list
Update MTP recipe: HTTP server example + vLLM caveat
Browse files
README.md
CHANGED
|
@@ -167,13 +167,28 @@ out = target.generate(
|
|
| 167 |
print(tok.decode(out[0][ids.shape[1]:], skip_special_tokens=True))
|
| 168 |
```
|
| 169 |
|
| 170 |
-
For
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 171 |
|
| 172 |
```bash
|
| 173 |
vllm serve igorls/gemma4-e4b-classifier \
|
| 174 |
--speculative-config '{"model": "google/gemma-4-E4B-it-assistant", "num_speculative_tokens": 4}'
|
| 175 |
```
|
| 176 |
|
|
|
|
|
|
|
| 177 |
## License
|
| 178 |
|
| 179 |
Inherited from the base model: [Gemma Terms of Use](https://ai.google.dev/gemma/terms). By using this model you agree to those terms.
|
|
|
|
| 167 |
print(tok.decode(out[0][ids.shape[1]:], skip_special_tokens=True))
|
| 168 |
```
|
| 169 |
|
| 170 |
+
For a self-hosted OpenAI-compatible HTTP endpoint, wrap the pair in a small FastAPI server that holds both models resident and exposes `/v1/chat/completions`. Example: [`scripts/08_mtp_server.py`](scripts/08_mtp_server.py) in the source repo, callable as:
|
| 171 |
+
|
| 172 |
+
```bash
|
| 173 |
+
curl http://localhost:8765/v1/chat/completions -d '{
|
| 174 |
+
"model": "igorls/gemma4-e4b-classifier",
|
| 175 |
+
"messages": [{"role":"user","content":"What is the capital of France?"}],
|
| 176 |
+
"max_tokens": 16,
|
| 177 |
+
"use_mtp": true
|
| 178 |
+
}'
|
| 179 |
+
```
|
| 180 |
+
|
| 181 |
+
### vLLM (future)
|
| 182 |
+
|
| 183 |
+
vLLM is the right inference stack for production throughput — it implements the drafter's centroid-masking optimization (sparse lm_head over ~4K candidates instead of ~262K vocab, ~45x reduction in lm_head compute):
|
| 184 |
|
| 185 |
```bash
|
| 186 |
vllm serve igorls/gemma4-e4b-classifier \
|
| 187 |
--speculative-config '{"model": "google/gemma-4-E4B-it-assistant", "num_speculative_tokens": 4}'
|
| 188 |
```
|
| 189 |
|
| 190 |
+
**However**, as of May 2026 (vLLM 0.20.2, latest on PyPI), this fails: the drafter's `Gemma4AssistantConfig` is not yet registered in vLLM's `AutoModel` mapping. The vLLM Gemma 4 recipes page documents the feature but it's ahead of the released version. Track [vllm-project/vllm](https://github.com/vllm-project/vllm/) for the release that lands `Gemma4Assistant` support; once available, the command above should work as-is against this model.
|
| 191 |
+
|
| 192 |
## License
|
| 193 |
|
| 194 |
Inherited from the base model: [Gemma Terms of Use](https://ai.google.dev/gemma/terms). By using this model you agree to those terms.
|