Instructions to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF 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 shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF 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 shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF: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 shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF: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 shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
Use Docker
docker model run hf.co/shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
- Ollama
How to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF with Ollama:
ollama run hf.co/shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF: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": "shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF with Docker Model Runner:
docker model run hf.co/shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
- Lemonade
How to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.OpenZero-Fusion-Qwen3-4B-Agentic-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF: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 shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF: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 "shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF: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"
OpenZero Fusion Qwen3-4B Agentic โ Standalone GGUF
THIS MODEL WORKS BUT HAS OUTPUT ERROR ISSUES.NOT RECOMMENDED FOR PRODUCTION. ONE FILE. TWO SPECIALISTS DISTILLED INTO ONE LOCAL AGENT.
OpenZero Fusion Qwen3-4B Agentic is a single-architecture Qwen3-4B student trained from the curated OpenZero corpus plus filtered outputs from the completed Qwen3-1.7B and Gemma4-E2B specialists. It is knowledge distillationโnot an invalid direct weight merge between unrelated architectures. Gemma 4 and Qwen 3 into 1 LLM made for CPU. Experimental model results may vary for this model.
What is included
| File | Purpose |
|---|---|
OpenZero-Fusion-Qwen3-4B-Agentic-Q4_K_M.gguf |
Recommended balance of size and quality |
OpenZero-Fusion-Qwen3-4B-Agentic-Q8_0.gguf |
Higher fidelity, larger download |
OpenZero-Fusion-Qwen3-4B-Agentic-F16.gguf |
Reference full-precision GGUF |
- Standalone model: yes
- Separate adapter required: no
- Separate base model required: no
- Base architecture:
Qwen/Qwen3-4B - Training mix: 2,606 curated examples + 379 filtered two-teacher examples = 2,985 training rows
- Held-out evaluation: 137 rows, never used for training
- Final held-out loss: 1.643606
- Held-out token accuracy: 0.788742
- GGUF conversion and CPU load test: passed for all three files with llama.cpp
Run with llama.cpp
hf download shafire/OpenZero-Fusion-Qwen3-4B-Agentic-GGUF OpenZero-Fusion-Qwen3-4B-Agentic-Q4_K_M.gguf --local-dir .
llama-cli -m OpenZero-Fusion-Qwen3-4B-Agentic-Q4_K_M.gguf --jinja -c 8192 -t 8 --temp 0.6 --top-p 0.95
For a local OpenAI-compatible endpoint:
llama-server -m OpenZero-Fusion-Qwen3-4B-Agentic-Q4_K_M.gguf --jinja -c 8192 -t 8 --host 127.0.0.1 --port 8080
Why Fusion exists
The small Qwen and Gemma specialists cannot safely be tensor-merged: their architectures and tokenizers differ. Fusion instead trains one compatible Qwen3-4B student using useful outputs from both teachers, producing a single deployable GGUF.
Verified release
- Full QLoRA training: 94/94 steps, one epoch
- Train loss: 2.158780
- Held-out evaluation loss: 1.643606
- Held-out token accuracy: 0.788742
Q4_K_Mโ 2,497,280,288 bytes โ SHA-256f00ad7bb04cb88c6861070e4b6176c9ee208030ae91ea9bb9ebeece7ee9ae415Q8_0โ 4,280,404,768 bytes โ SHA-2568430bcfe6704c53cfa0f8d3e30d141d78730e1d47bcd80515413ec24a090317cF16โ 8,051,284,768 bytes โ SHA-25629069c52929b50681d08cfc2564cf7e443b3b0c286fbf6b8ad1d285f11d11196
Provenance and reproducibility
The student used 2,606 original OpenZero instruction rows plus 379 filtered teacher-response rows, for 2,985 training rows total. Teacher generation began with 192 balanced prompts across general, coding, research and agent/tool categories; both specialists produced a candidate for each prompt. A separate 137-row held-out set was never used for training. The completed V6 adapter was merged only into Qwen/Qwen3-4B revision 1cfa9a7208912126459214e8b04321603b3df60c. F16 was converted with llama.cpp b10333 / commit 08659901c43b51de735740f1cf61bb82fbe0c4e4; Q8_0 and Q4_K_M were independently quantized from that F16 source. Every file passed a bounded one-shot CPU text load test (-c 128 -n 1 -ngl 0 --no-conversation --single-turn --simple-io --no-warmup) and remote LFS/Xet SHA-256 verification.
This distillation transfers examples, not tensors. It does not make a 4B model equivalent to the sum of two architectures, and the reported held-out metrics are not broad benchmark claims. Tool calls are text emitted for an external runtime to validate and execute.
This model is an independent fine-tune based on Qwen and is not affiliated with or endorsed by Qwen. The Qwen base is Apache-2.0. OpenZero training materials and resulting community release are subject to the OpenZero Community Source terms; do not describe this release as OSI-approved open source. Review both upstream and OpenZero terms before redistribution or commercial use.
- Downloads last month
- 206
4-bit
8-bit
16-bit
