Instructions to use Ninnix96/Qwengram-2B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use Ninnix96/Qwengram-2B 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 Ninnix96/Qwengram-2B:Q4_K_M # Run inference directly in the terminal: llama cli -hf Ninnix96/Qwengram-2B:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Ninnix96/Qwengram-2B:Q4_K_M # Run inference directly in the terminal: llama cli -hf Ninnix96/Qwengram-2B:Q4_K_M
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf Ninnix96/Qwengram-2B:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama cli -hf Ninnix96/Qwengram-2B:Q4_K_M
Use Docker
docker model run hf.co/Ninnix96/Qwengram-2B:Q4_K_M
- Llama new
- LM Studio
- Jan
- vLLM
How to use Ninnix96/Qwengram-2B with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Ninnix96/Qwengram-2B" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Ninnix96/Qwengram-2B", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Ninnix96/Qwengram-2B:Q4_K_M
- Ollama
How to use Ninnix96/Qwengram-2B with Ollama:
ollama run hf.co/Ninnix96/Qwengram-2B:Q4_K_M
- Unsloth Desktop
- Pi
How to use Ninnix96/Qwengram-2B with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Ninnix96/Qwengram-2B:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "Ninnix96/Qwengram-2B:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use Ninnix96/Qwengram-2B with Docker Model Runner:
docker model run hf.co/Ninnix96/Qwengram-2B:Q4_K_M
- Lemonade
How to use Ninnix96/Qwengram-2B with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Ninnix96/Qwengram-2B:Q4_K_M
Run and chat with the model
lemonade run user.Qwengram-2B-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use Ninnix96/Qwengram-2B with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Ninnix96/Qwengram-2B: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 Ninnix96/Qwengram-2B:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use Ninnix96/Qwengram-2B with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Ninnix96/Qwengram-2B: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 "Ninnix96/Qwengram-2B: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"
Download runtime/README.md from Ninnix96/Qwengram-2B: direct link, hf CLI and curl.
- Browser
- Download file 2.92 kB
-
https://huggingface.co/Ninnix96/Qwengram-2B/resolve/main/runtime/README.md
- Command line
-
hf download hf://Ninnix96/Qwengram-2B/runtime/README.md
-
curl -L -o README.md https://huggingface.co/Ninnix96/Qwengram-2B/resolve/main/runtime/README.md
Qwengram-2B GGUF runtime validation
Canonical checkpoint: REAL-15M + linear750. The milestone comparison records the frozen 15M evaluation and the superseded conservative 10M selection.
| Precision | Stock NLL | Qwengram NLL | Reader gain [95% CI] | Gain retention [95% CI] | Perplexity reduction vs stock |
|---|---|---|---|---|---|
| BF16 | 2.538120 | 2.486529 | 0.051591 [0.037129, 0.066689] | 100% | 5.03% |
| Q8_0 | 2.539465 | 2.487978 | 0.051487 [0.037551, 0.066078] | 99.8% [98.3%, 101.8%] | 5.02% |
| Q6_K | 2.551537 | 2.497033 | 0.054504 [0.039340, 0.070659] | 105.6% [98.1%, 112.6%] | 5.30% |
| Q4_K_M | 2.577519 | 2.525079 | 0.052440 [0.037291, 0.067937] | 101.6% [95.1%, 108.2%] | 5.11% |
Matched test
The matched CPU test scores 8,128 tokens from the first 64 consecutive 256-token WikiText-2 raw test chunks, scoring the last 127 tokens per chunk. All runs use eight threads and context/batch/microbatch 256, with no warmup. Reader gain is NLL(stock) - NLL(Qwengram); retention divides each quantized gain by the BF16 gain. Paired 95% intervals use 10,000 resamples of 16 consecutive four-chunk blocks, seed 1234. The external PLE is Ivan Fioravanti's Q4_1 sidecar.
The four Qwengram runs were repeated for this 15M release. Stock controls reuse the existing verified runs: the backbone tensors, tokenizer, input text and CPU runtime binary hashes are unchanged. Per-chunk scores and model hashes are in results.json; exact commands and logs are in logs.
All 335 backbone tensors and nine tokenizer fields match exactly within each stock/Qwengram pair. All 11 reader/arbiter tensors remain bit-exact FP32 across BF16, Q8_0, Q6_K and Q4_K_M. Their values match the hash-verified 15M reader and matching linear750 arbiter. See packaging, verification and Q6 verification.
The Q4_1 PLE sidecar is host mapped and has SHA256 66db3ab390f4dd5063ecc89cc180f4713898577682347001bf64ab8e328527a1. The existing sidecar validation checks 4,096 addressed rows against independent reference addressing and dequantization, including prefill, decoding, EOS boundaries and reset. The reader checkpoint change does not change PLE addressing or dequantization.
This CPU test uses a quantized Q4_1 PLE and a WikiText-2 slice. The frozen Kaggle study uses the original FP8 PLE and different evaluation streams. These scores are separate benchmarks.
Generation checks
On the tested AMD BC-250, BF16, Q8_0, Q6_K, Q4_K_M with full Vulkan offload (-ngl 99) matched the corresponding CPU eight-token greedy continuation for The capital of France is. These short checks do not establish broad GPU parity.
The loader rejected missing and invalid PLE sidecars. See smoke.json and the separate Q6 output.