Instructions to use PollardWeights/Spark-X2.5-4B-Pollard with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Trellis
How to use PollardWeights/Spark-X2.5-4B-Pollard with Trellis:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use PollardWeights/Spark-X2.5-4B-Pollard 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 PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S # Run inference directly in the terminal: llama cli -hf PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S # Run inference directly in the terminal: llama cli -hf PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
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 PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S # Run inference directly in the terminal: ./build/bin/llama cli -hf PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
Use Docker
docker model run hf.co/PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
- Llama new
- LM Studio
- Jan
- vLLM
How to use PollardWeights/Spark-X2.5-4B-Pollard with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "PollardWeights/Spark-X2.5-4B-Pollard" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "PollardWeights/Spark-X2.5-4B-Pollard", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
- Ollama
How to use PollardWeights/Spark-X2.5-4B-Pollard with Ollama:
ollama run hf.co/PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
- Unsloth Desktop
- Pi
How to use PollardWeights/Spark-X2.5-4B-Pollard with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
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": "PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use PollardWeights/Spark-X2.5-4B-Pollard with Docker Model Runner:
docker model run hf.co/PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
- Lemonade
How to use PollardWeights/Spark-X2.5-4B-Pollard with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
Run and chat with the model
lemonade run user.Spark-X2.5-4B-Pollard-IQ3_S
List all available models
lemonade list
- Hermes Agent
How to use PollardWeights/Spark-X2.5-4B-Pollard with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
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 PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use PollardWeights/Spark-X2.5-4B-Pollard with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S
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 "PollardWeights/Spark-X2.5-4B-Pollard:IQ3_S" \ --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"
Spark-X2.5-4B — Pollard
Pollard shrank this model: 8.22 GB (f16) → 1.93 GB — 77% smaller, 4.3× down.
The smallest rung here; larger, higher-fidelity rungs are listed below.
format this model's size f16 8.22 GB Q8_0 ~4.36 GB Q6_K ~3.37 GB Q4_K_M ~2.38 GB PollardMix (this repo's IQ3_S) 1.93 GB
Pollard builds of XHToken/Spark-X2.5-4B made with Pollard Weights — a ladder of measured-allocation quants (bits placed by per-layer sensitivity, not a uniform crush).
Standard GGUF, but you need a recent llama.cpp. This model's architecture (spark2_5) is implemented upstream, so any build new enough to carry it runs these files -- llama.cpp itself, and Ollama or LM Studio once they ship a runtime with it. An older build will refuse them with unknown model architecture. The quants are ordinary K-quants.
Model details
| Parameter count | ~4.1B |
| Architecture | spark2_5 |
| Input support | text |
| imatrix | no |
| Perplexity measured | yes — table below |
Which file should I choose?
Every rung is the same weights, sized to a different RAM budget by the measured allocation. Pick the largest one that fits your machine with room for context:
- ~5 GB RAM / VRAM →
Q6_K(3.38 GB). (needs a current llama.cpp) near-lossless - ~4 GB RAM / VRAM →
IQ4_XS(2.42 GB). (needs a current llama.cpp) recommended default - ~4 GB RAM / VRAM →
IQ3_S(1.93 GB). (needs a current llama.cpp) smallest
Available files (Calib 3.0 corpus, ctx 512, 6 chunks)
f16 reference PPL 6.091...
| file | PPL | size | Mean KLD | notes |
|---|---|---|---|---|
Spark-X2.5-4B-Pollard-IQ3_S.gguf |
6.781 | 1.93 GB | — | smallest |
Spark-X2.5-4B-Pollard-IQ4_XS.gguf |
6.207 | 2.42 GB | — | recommended default |
Spark-X2.5-4B-Pollard-Q6_K.gguf |
6.099 | 3.38 GB | — | near-lossless |
Measured notes
f16 reference PPL 6.091.
Measured notes
f16 reference PPL 6.091..
Download a specific file
pip install -U "huggingface_hub[cli]"
hf download PollardWeights/Spark-X2.5-4B-Pollard \
--include "Spark-X2.5-4B-Pollard-IQ4_XS.gguf" --local-dir ./
How to run
This model's architecture (spark2_5) needs a llama.cpp new enough to carry it, so build or update from upstream first:
llama-cli -m Spark-X2.5-4B-Pollard-IQ4_XS.gguf -ngl 99 -p "Explain why the sky is blue."
llama-server -m Spark-X2.5-4B-Pollard-IQ4_XS.gguf -ngl 99
Ollama and LM Studio will run these once their bundled llama.cpp carries spark2_5.
ARM / AVX
llama.cpp repacks weights into an interleaved layout at load time for faster inference on ARM and AVX machines — no special file needed, online repacking covers these quants. The old Q4_0_4_4/4_8/8_8 variants are not required.
Errata
general.architectureisspark2_5, which upstream llama.cpp added recently. A build older than that support refuses these files withunknown model architecture— update llama.cpp rather than looking for a different quant. Checked withpollard-ggufcheck, which reads the architecture and the tensor types out of the header and asks upstream what it implements.- Measured allocation places bits by per-layer sensitivity under a size budget.
- Single machine; replication invited.
Credits & license
- Base model:
XHToken/Spark-X2.5-4B - Quantization tooling: llama.cpp (ggml-org)
- Method + tooling: Pollard Weights — measure first, no claim before a number.
- License:
apache-2.0, inherited from the base model.
Built with Pollard Weights — frontier models, small hardware, no compromise.
- Downloads last month
- 70
3-bit
4-bit
6-bit