Instructions to use minsore/quill-1-preview 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 minsore/quill-1-preview 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 minsore/quill-1-preview:F16 # Run inference directly in the terminal: llama cli -hf minsore/quill-1-preview:F16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf minsore/quill-1-preview:F16 # Run inference directly in the terminal: llama cli -hf minsore/quill-1-preview:F16
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 minsore/quill-1-preview:F16 # Run inference directly in the terminal: ./llama-cli -hf minsore/quill-1-preview:F16
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 minsore/quill-1-preview:F16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf minsore/quill-1-preview:F16
Use Docker
docker model run hf.co/minsore/quill-1-preview:F16
- LM Studio
- Jan
- vLLM
How to use minsore/quill-1-preview with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "minsore/quill-1-preview" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "minsore/quill-1-preview", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/minsore/quill-1-preview:F16
- Ollama
How to use minsore/quill-1-preview with Ollama:
ollama run hf.co/minsore/quill-1-preview:F16
- Unsloth Desktop
- Pi
How to use minsore/quill-1-preview with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf minsore/quill-1-preview:F16
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": "minsore/quill-1-preview:F16" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use minsore/quill-1-preview with Docker Model Runner:
docker model run hf.co/minsore/quill-1-preview:F16
- Lemonade
How to use minsore/quill-1-preview with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull minsore/quill-1-preview:F16
Run and chat with the model
lemonade run user.quill-1-preview-F16
List all available models
lemonade list
- Hermes Agent
How to use minsore/quill-1-preview with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf minsore/quill-1-preview:F16
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 minsore/quill-1-preview:F16
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use minsore/quill-1-preview with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf minsore/quill-1-preview:F16
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 "minsore/quill-1-preview:F16" \ --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"
🟢 Quill 1 Preview
Lightweight FIM autocomplete model for Python, built on Qwen2.5-Coder-0.5B.
Quill is a 0.5B parameter code-completion model designed for Fill-in-the-Middle (FIM) tasks in IDEs and editors. It runs comfortably on consumer hardware and is one of the few publicly available 0.5B models trained specifically for autocomplete.
Part of the Minsore family · minsore.com
✨ Highlights
- 🧠 FIM-native — understands
<fim_prefix>,<fim_suffix>,<fim_middle> - ⚡ Real-time — designed for live autocomplete in editors
- 📦 Tiny — 0.5B params, ~400 MB in Q4_K_M
- 🎯 Purpose-built — trained for autocomplete, not chat
- 🆓 Apache 2.0 — same license as base model
📊 Benchmarks
Evaluated against 0.5B–1B code models. All runs used temperature=0.0, raw FIM mode (--chat-template none).
| Benchmark | Quill 1 Preview | Arche-Codium 0.5B | Granite 4.0 1B | Qwen2.5-Coder 0.5B |
|---|---|---|---|---|
| HumanEval@50 | 54.0% | 96.0% | 58.0% | 52.0% |
| HumanEval-Infilling (EditSim) | 0.423 | 0.053 | 0.041 | 0.045 |
| HumanEval-Infilling (Exact Match) | 16% | 0% | 0% | 0% |
| NextBench v0.2 (autocomplete) | 45.0% | 5.0% | 25.0% | 41.7% |
| Delulu FIM (EditSim) | 0.318 | 0.087 | 0.041 | 0.035 |
📌 Key insight: On FIM-specific benchmarks, Quill outperforms competitors by 8–10×. On pure code generation (HumanEval), it matches the base model — training added FIM capability without hurting generation.
🚀 Quick Start
llama.cpp
llama-server -m quill-1-preview.Q4_K_M.gguf \
--port 8080 \
-ngl 99 \
--chat-template none
Requirements: any GPU with ≥2 GB VRAM (full offload), or partial CPU offload as fallback.
FIM request
curl http://localhost:8080/infill \
-H "Content-Type: application/json" \
-d '{
"input_prefix": "def add(a, b):\n ",
"input_suffix": "\n\nprint(add(2, 3))",
"n_predict": 64,
"temperature": 0.0
}'
Response:
{
"content": "return a + b",
"stop": true
}
Python
import requests
def fim_complete(prefix, suffix, max_tokens=64):
r = requests.post("http://localhost:8080/infill", json={
"input_prefix": prefix,
"input_suffix": suffix,
"n_predict": max_tokens,
"temperature": 0.0,
"stop": ["<fim_end>", "<|endoftext|>"],
})
return r.json()["content"]
print(fim_complete(
"def fib(n):\n if n <= 1:\n return n\n return ",
"\n\nprint(fib(10))"
))
# → "fib(n - 1) + fib(n - 2)"
⚙️ Recommended Settings
| Parameter | Value | Notes |
|---|---|---|
n_predict |
128–256 | Works best on short completions |
temperature |
0.0 | Deterministic; for creative variation use 0.2 |
repeat_penalty |
1.1 | Prevents number-looping |
stop |
`["", "< | endoftext |
--chat-template |
none |
Required. Quill is not a chat model |
⚠️ Limitations
- Autocomplete only — does not work as a chat assistant
- Occasionally appends tests after the function (inherited from mixed training data)
- Number looping — may repeat large integers on some prompts (use
repeat_penalty=1.1) - 1024 token context — long files are truncated
- Python-only — trained on Python FIM data
- Hallucinations on unfamiliar APIs (EditSim 0.318 on Delulu FIM benchmark)
🧬 Training Details
| Base model | Qwen2.5-Coder-0.5B-Instruct |
| Method | QLoRA (r=16, α=16) |
| Data | Mixed FIM + Python instruction data |
| Epochs | 1 |
| Context | 1024 tokens |
| FIM tokens | <fim_prefix>, <fim_suffix>, <fim_middle>, <fim_pad> |
📁 Files
| File | Size | Description |
|---|---|---|
quill-1-preview.Q4_K_M.gguf |
~400 MB | Ready to use (recommended) |
quill-1-preview-f16.gguf |
~1 GB | Full precision GGUF |
lora/ |
~35 MB | LoRA adapter for fine-tuning |
🗺️ Roadmap
- Quill 2 — fix number looping, raise
pattern_hitto 70%+ - Quill 2 — multi-language support (JS/TS/Rust)
- Pepper — general-purpose code assistant (1.7B)
- Symphony — flagship code model (3B)
📜 License
Apache 2.0 — same as the base Qwen2.5-Coder-0.5B model.
🙏 Credits
- Base model: Qwen2.5-Coder-0.5B-Instruct by Alibaba Cloud
- Training framework: Unsloth
- Inference: llama.cpp
📬 Contact
Minsore — Ukrainian AI lab building open language models.
- 🌐 minsore.com
- 🤗 huggingface.co/Minsore
- 💬 Built by @Sollamon
⭐ If Quill is useful, star the repo and share your results.
- Downloads last month
- -
Model tree for minsore/quill-1-preview
Base model
Qwen/Qwen2.5-0.5B