Instructions to use 20ZollCoder/quant-pico-2b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use 20ZollCoder/quant-pico-2b with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="20ZollCoder/quant-pico-2b") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("20ZollCoder/quant-pico-2b", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use 20ZollCoder/quant-pico-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 20ZollCoder/quant-pico-2b:Q4_K_M # Run inference directly in the terminal: llama cli -hf 20ZollCoder/quant-pico-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 20ZollCoder/quant-pico-2b:Q4_K_M # Run inference directly in the terminal: llama cli -hf 20ZollCoder/quant-pico-2b: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 20ZollCoder/quant-pico-2b:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf 20ZollCoder/quant-pico-2b: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 20ZollCoder/quant-pico-2b:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf 20ZollCoder/quant-pico-2b:Q4_K_M
Use Docker
docker model run hf.co/20ZollCoder/quant-pico-2b:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use 20ZollCoder/quant-pico-2b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "20ZollCoder/quant-pico-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": "20ZollCoder/quant-pico-2b", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/20ZollCoder/quant-pico-2b:Q4_K_M
- SGLang
How to use 20ZollCoder/quant-pico-2b 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 "20ZollCoder/quant-pico-2b" \ --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": "20ZollCoder/quant-pico-2b", "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 "20ZollCoder/quant-pico-2b" \ --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": "20ZollCoder/quant-pico-2b", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use 20ZollCoder/quant-pico-2b with Ollama:
ollama run hf.co/20ZollCoder/quant-pico-2b:Q4_K_M
- Unsloth Studio
How to use 20ZollCoder/quant-pico-2b 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 20ZollCoder/quant-pico-2b 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 20ZollCoder/quant-pico-2b to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for 20ZollCoder/quant-pico-2b to start chatting
- Pi
How to use 20ZollCoder/quant-pico-2b with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf 20ZollCoder/quant-pico-2b: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": "20ZollCoder/quant-pico-2b:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use 20ZollCoder/quant-pico-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 20ZollCoder/quant-pico-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 20ZollCoder/quant-pico-2b:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use 20ZollCoder/quant-pico-2b with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf 20ZollCoder/quant-pico-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 "20ZollCoder/quant-pico-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"
- Docker Model Runner
How to use 20ZollCoder/quant-pico-2b with Docker Model Runner:
docker model run hf.co/20ZollCoder/quant-pico-2b:Q4_K_M
- Lemonade
How to use 20ZollCoder/quant-pico-2b with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull 20ZollCoder/quant-pico-2b:Q4_K_M
Run and chat with the model
lemonade run user.quant-pico-2b-Q4_K_M
List all available models
lemonade list
# Load model directly
from transformers import AutoModel
model = AutoModel.from_pretrained("20ZollCoder/quant-pico-2b", device_map="auto")Quant Pico 2B
A 2B-parameter German-and-English instruction-tuned language model, fine-tuned from Qwen3.5-2B (a.k.a. Qwen3-Next-2B) using QLoRA + DoRA across six sequential SFT phases. Trained on a single Vast.ai RTX A4000 instance. Designed for local inference on consumer GPUs (RTX 2060 / 3060 / 3090) and small-VRAM quantized serving via llama.cpp / Ollama.
Model details
- Architecture: Qwen3_5ForCausalLM (hybrid SSM + sparse full attention,
full_attention_interval=4) - Parameters: ~2.0B (hidden 2048, intermediate 6144, 24 layers)
- Context length: 262 144 tokens (inherited from base)
- Tokenizer: Qwen3.5 BPE, vocab 248 320, EOS
248044 - Precision: bfloat16 (safetensors), plus f16 and Q4_K_M GGUF siblings
- Chat template: Standard Qwen3.5 chatml (vision/tool blocks included for compatibility; this is a text-only fine-tune)
Training
- Base model:
Qwen/Qwen3-Next-2B(branded "Qwen3.5 2B" in our internal naming) - Method: QLoRA (4-bit base) + DoRA, r=96, alpha=192, all linear modules
- Phases (sequential SFT, ~42h wall-clock on A4000):
- Code
- Math
- Reasoning
- German
- Tool use
- Chat / mix
- Identity tuning: Yes โ the model adopts the persona "Quant Pico 2B" via German-language system-prompt conditioning. See Limitations below.
- NEFTune: enabled
- Optimiser: paged_adamw_8bit
- Hardware: Vast.ai RTX A4000 (~$210 total)
Note on data disclosure. Full per-phase dataset lists and token counts are recorded in the private training log. This card summarises the phase ordering and qualitative intent; the exact source datasets are not enumerated here.
Intended use
- Local chat assistant on consumer hardware (German + English)
- Code and math assistance at the 2B-class capability ceiling
- Tool-calling experiments (template supports it; coverage is partial)
Out-of-scope
- Production safety-critical applications
- High-stakes reasoning (medical, legal, financial)
- Long-context retrieval beyond what the base Qwen3.5-2B supports reliably in our benchmarks
Limitations
- Persona conditioning: The model is biased toward responding as "Quant Pico 2B, ein hilfsbereiter deutschsprachiger KI-Assistent" when prompted. This is intentional, but downstream users may want to override the system prompt to neutralise it.
- 2B-class ceiling: Code, math, and reasoning quality are bounded by the base model size. Do not expect frontier-model performance.
- Hybrid-attention quirks: The base uses linear (SSM-style) attention
on most layers. Generation quality is sensitive to
temperatureandtop_p; defaults baked into the Ollama Modelfile are0.7 / 0.9. - No RLHF or DPO: This is pure SFT. There is no preference learning.
Files in this repo
| File | Purpose |
|---|---|
final_model/model.safetensors |
HF-format weights, bfloat16 |
final_model/{config,generation_config,tokenizer,tokenizer_config}.json |
HF model + tokenizer metadata |
final_model/chat_template.jinja |
Qwen3.5 chatml template |
quant-pico-2b-f16.gguf |
llama.cpp / Ollama format, 16-bit |
quant-pico-2b-Q4_K_M.gguf |
llama.cpp / Ollama format, Q4 quant (~1.2 GB) |
Modelfile |
Ollama recipe (German system prompt, sampling defaults) |
How to use
With Hugging Face transformers
from transformers import AutoModelForCausalLM, AutoTokenizer
import torch
tok = AutoTokenizer.from_pretrained("20ZollCoder/quant-pico-2b", subfolder="final_model")
model = AutoModelForCausalLM.from_pretrained(
"20ZollCoder/quant-pico-2b",
subfolder="final_model",
torch_dtype=torch.bfloat16,
device_map="auto",
)
messages = [
{"role": "system", "content": "Du bist Quant Pico 2B, ein hilfsbereiter deutschsprachiger KI-Assistent."},
{"role": "user", "content": "Erklaere mir in zwei Saetzen, was ein QLoRA ist."},
]
prompt = tok.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
inputs = tok(prompt, return_tensors="pt").to(model.device)
out = model.generate(**inputs, max_new_tokens=200, temperature=0.7, top_p=0.9, do_sample=True)
print(tok.decode(out[0][inputs.input_ids.shape[1]:], skip_special_tokens=True))
With Ollama
# After pulling this repo
ollama create quant-pico-2b -f Modelfile
ollama run quant-pico-2b
With llama.cpp
./llama-server -m quant-pico-2b-Q4_K_M.gguf -ngl 999 --port 8080
Eval
No formal benchmarks are reported in this card. The model is in active internal use; informal observations are summarised in the Limitations section. A future revision will add lm-eval-harness numbers.
Provenance
- Trained and packaged by
20ZollCoderon a single Vast.ai A4000 instance, deployed and validated on a local MilanLinux RTX 2060 box. - Build pipeline and phase scripts live in the
llm-finetuning-pipelinereference suite; see thelocal-llm-finetune-and-serveskill (open-source documentation) for the patterns used.
License
Apache 2.0, matching the base model. You may use, modify, and redistribute under the terms of that license. Attribution to the original Qwen3.5-2B authors (Alibaba) and to this fine-tune is appreciated but not required.
- Downloads last month
- 50
4-bit
16-bit
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="20ZollCoder/quant-pico-2b") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)