Instructions to use PollardWeights/FrogNano-4B-2609-Pollard with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Trellis
How to use PollardWeights/FrogNano-4B-2609-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/FrogNano-4B-2609-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/FrogNano-4B-2609-Pollard:Q2_K # Run inference directly in the terminal: llama cli -hf PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf PollardWeights/FrogNano-4B-2609-Pollard:Q2_K # Run inference directly in the terminal: llama cli -hf PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
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 PollardWeights/FrogNano-4B-2609-Pollard:Q2_K # Run inference directly in the terminal: ./llama-cli -hf PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
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 PollardWeights/FrogNano-4B-2609-Pollard:Q2_K # Run inference directly in the terminal: ./build/bin/llama-cli -hf PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
Use Docker
docker model run hf.co/PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
- LM Studio
- Jan
- vLLM
How to use PollardWeights/FrogNano-4B-2609-Pollard with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "PollardWeights/FrogNano-4B-2609-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/FrogNano-4B-2609-Pollard", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
- Ollama
How to use PollardWeights/FrogNano-4B-2609-Pollard with Ollama:
ollama run hf.co/PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
- Unsloth Desktop
- Pi
How to use PollardWeights/FrogNano-4B-2609-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/FrogNano-4B-2609-Pollard:Q2_K
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/FrogNano-4B-2609-Pollard:Q2_K" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use PollardWeights/FrogNano-4B-2609-Pollard with Docker Model Runner:
docker model run hf.co/PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
- Lemonade
How to use PollardWeights/FrogNano-4B-2609-Pollard with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull PollardWeights/FrogNano-4B-2609-Pollard:Q2_K
Run and chat with the model
lemonade run user.FrogNano-4B-2609-Pollard-Q2_K
List all available models
lemonade list
- Hermes Agent
How to use PollardWeights/FrogNano-4B-2609-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/FrogNano-4B-2609-Pollard:Q2_K
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/FrogNano-4B-2609-Pollard:Q2_K
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use PollardWeights/FrogNano-4B-2609-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/FrogNano-4B-2609-Pollard:Q2_K
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/FrogNano-4B-2609-Pollard:Q2_K" \ --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"
FrogNano-4B-2609 -- Pollard
Pollard shrank this model: 8.65 GB (f16) -> 1.42 GB -- 84% smaller, 6.1x down.
The smallest rung here; larger, higher-fidelity rungs are listed below.
format this model's size f16 8.65 GB Q8_0 ~4.59 GB Q6_K 3.56 GB Q4_K_M ~2.51 GB PollardMix (this repo's IQ2_KT) 1.42 GB
Pollard builds of microsoft/FrogNano-4B-2609 made with Pollard Weights -- a ladder of measured-allocation quants (bits placed by per-layer sensitivity, not a uniform crush).
Standard GGUF -- runs in stock llama.cpp / ik_llama.cpp, Ollama, LM Studio, except where noted. IQ2_KT needs ik_llama.cpp: its allocation puts ik_llama-only atoms on the tensors it protects. The rest run anywhere.
Model details
| Parameter count | ~4.3B |
| Architecture | qwen3_5 |
| Input support | text, image |
| imatrix | yes -- see calibration |
| Perplexity measured | yes -- WikiText-2, 64 × 2048-token chunks, vs f16 (PPL 9.338) |
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.6 GB RAM / VRAM ->
Q6_K(3.56 GB). - ~4.5 GB RAM / VRAM ->
IQ4_XS(2.48 GB). - ~4.1 GB RAM / VRAM ->
IQ3_S(2.06 GB). - ~3.4 GB RAM / VRAM ->
IQ2_KT(1.42 GB). (ik_llama.cpp)
Available files
| file | PPL | size | Mean KLD | runs in | notes |
|---|---|---|---|---|---|
FrogNano-4B-2609-Pollard-IQ2_KT.gguf |
13.51 | 1.42 GB | 0.614 | ik_llama | smallest · top-1 68.0% |
FrogNano-4B-2609-Pollard-IQ3_S.gguf |
9.59 | 2.06 GB | 0.248 | any llama.cpp | top-1 80.7% |
FrogNano-4B-2609-Pollard-IQ4_XS.gguf |
9.08 | 2.48 GB | 0.185 | any llama.cpp | top-1 83.8% |
FrogNano-4B-2609-Pollard-Q6_K.gguf |
9.44 | 3.56 GB | 0.019 | any llama.cpp | largest · top-1 96.0% · near-lossless |
Measured on WikiText-2 (64 chunks × 2048 tokens) against the f16 original (PPL 9.338): Mean KLD = average divergence of each rung's next-token distribution from f16 (lower is closer); top-1 = how often the rung's most likely next token matches f16's. FrogNano is an instruct/thinking model, so raw-text perplexity reads higher than on chat text; compare rungs by KLD.
Coherence gate
Every rung is checked by Pollard's coherence gate before it ships. The IQ2_KT flagship (1.42 GB, ik_llama.cpp) passes all three gate prompts (factual, explanation, code) and stops on its own end-of-turn token. Recommended sampling, from the gate's sweep:
--temp 0.7 --repeat-penalty 1.15 --repeat-last-n 256 --top-k 40 --top-p 0.9
The allocation behind these rungs is measured per layer on FrogNano itself (pollard-probe, 32 layers). Perplexity and mean KLD against f16 for every rung are in the table above: Q6_K is near-lossless (mean KLD 0.019, 96% top-1 agreement with f16).
Multimodal
Vision needs the projector shipped alongside: mmproj-FrogNano-4B-2609-BF16.gguf -- download it too and pass it with --mmproj. It is not quantized; it is small and the text ladder is where the size lives.
llama-server -m FrogNano-4B-2609-Pollard-IQ2_KT.gguf --mmproj mmproj-FrogNano-4B-2609-BF16.gguf -ngl 99
Download a specific file
pip install -U "huggingface_hub[cli]"
hf download PollardWeights/FrogNano-4B-2609-Pollard \
--include "FrogNano-4B-2609-Pollard-IQ2_KT.gguf" --local-dir ./
How to run
IQ2_KT is built on ik_llama-only atoms, so it runs with ik_llama.cpp:
llama-cli -m FrogNano-4B-2609-Pollard-IQ2_KT.gguf -ngl 99 -p "Explain why the sky is blue."
llama-server -m FrogNano-4B-2609-Pollard-IQ2_KT.gguf -ngl 99
For stock llama.cpp, Ollama or LM Studio, use Q6_K instead:
llama-server -hf PollardWeights/FrogNano-4B-2609-Pollard:Q6_K
llama-cli -m FrogNano-4B-2609-Pollard-Q6_K.gguf -ngl 99 -p "Explain why the sky is blue."
imatrix (calibration)
The importance matrix (FrogNano-4B-2609-Pollard.imatrix, included) was computed on Calib 3.0 multi-domain calibration.
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
IQ2_KTcarries ik_llama-only atoms and needs ik_llama.cpp to run; stock llama.cpp rejects any ggml type above 42 outright. Checked withpollard-ggufcheck, from the files' tensor types rather than their names.- Measured allocation places bits by per-layer sensitivity under a size budget.
- Single machine; replication invited.
Credits & license
- Base model:
microsoft/FrogNano-4B-2609 - Quantization tooling: llama.cpp (ggml-org)
- Method + tooling: Pollard Weights -- measure first, no claim before a number.
- License:
mit, inherited from the base model.
Built with Pollard Weights -- frontier models, small hardware, no compromise.
- Downloads last month
- 805
2-bit
3-bit
4-bit
6-bit
Model tree for PollardWeights/FrogNano-4B-2609-Pollard
Base model
microsoft/FrogNano-4B-2609