Instructions to use Veyllo/VQ-1_Instruct-q4_k_m with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use Veyllo/VQ-1_Instruct-q4_k_m with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="Veyllo/VQ-1_Instruct-q4_k_m", filename="VQ-1_Instruct-q4_k_m.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use Veyllo/VQ-1_Instruct-q4_k_m with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M # Run inference directly in the terminal: llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M # Run inference directly in the terminal: llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m: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 Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m: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 Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
Use Docker
docker model run hf.co/Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use Veyllo/VQ-1_Instruct-q4_k_m with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Veyllo/VQ-1_Instruct-q4_k_m" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Veyllo/VQ-1_Instruct-q4_k_m", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
- Ollama
How to use Veyllo/VQ-1_Instruct-q4_k_m with Ollama:
ollama run hf.co/Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
- Unsloth Studio
How to use Veyllo/VQ-1_Instruct-q4_k_m 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 Veyllo/VQ-1_Instruct-q4_k_m 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 Veyllo/VQ-1_Instruct-q4_k_m to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Veyllo/VQ-1_Instruct-q4_k_m to start chatting
- Pi
How to use Veyllo/VQ-1_Instruct-q4_k_m with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf Veyllo/VQ-1_Instruct-q4_k_m: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": "Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use Veyllo/VQ-1_Instruct-q4_k_m with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf Veyllo/VQ-1_Instruct-q4_k_m: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 Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
Run Hermes
hermes
- Docker Model Runner
How to use Veyllo/VQ-1_Instruct-q4_k_m with Docker Model Runner:
docker model run hf.co/Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
- Lemonade
How to use Veyllo/VQ-1_Instruct-q4_k_m with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M
Run and chat with the model
lemonade run user.VQ-1_Instruct-q4_k_m-Q4_K_M
List all available models
lemonade list
Install from WinGet (Windows)
winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama-server -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M# Run inference directly in the terminal:
llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_MUse 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 Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M# Run inference directly in the terminal:
./llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_MBuild 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 Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M# Run inference directly in the terminal:
./build/bin/llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_MUse Docker
docker model run hf.co/Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_MVeyllo VQ-1: High-Density Reasoning
VQ-1 (Veyllo Qwen V1) is a proof-of-concept model demonstrating efficient reasoning on consumer hardware by reduce token consumption and loop failures in complex logical tasks compared to the base model.
By fine-tuning a constrained, 4-bit quantized base model (Qwen 3 8B) on a small, high logic density dataset of 3,260 reasoning examples, VQ-1 achieves state-of-the-art efficiency in logical tasks. It outperforms its own unquantized base model and larger "reasoning" models in terms of token efficiency and stability.
β‘ Key Highlights
- Efficiency First: Optimized for the Reasoning Efficiency Score (RES). It solves complex problems without "thinking" for 1,000 tokens.
- 4-Bit Native: Trained directly on top of the 4-bit quantized weights of Qwen 3 using QLoRA.
- Stable Logic: Eliminates the "collapse" and loops often seen in base models when handling strict constraints (e.g., Modulo Math, Resource Triage).
π Evaluation: Precision Beats Volume
We benchmarked VQ-1 against the Qwen 3 Base model and leading reasoning models. The goal was not just accuracy, but efficiency (Accuracy per Token).
The Reasoning Efficiency Score (RES)
Results
(See the "All Tasks RES Comparison" chart in the linked Engineering Note)
- vs. Base Model: VQ-1 consistently outperforms the Qwen 3 base model in tasks requiring strict constraints, using significantly fewer tokens.
- vs. Reasoning Models: While larger reasoning models provide correct answers, they often require 2-3x the token count to derive them. VQ-1 finds the solution, drastically reducing latency.
| Metric | VQ-1 (Ours) | Qwen 3 Base | Competitor (Reasoning) |
|---|---|---|---|
| Avg. Tokens per Solution | ~660 | ~993 | ~1200+ |
| Logic Stability | High | Low (Loops) | High |
π» How to Use
Option 1: Terminal / llama.cpp (Recommended & Stable) π
This is the most reliable method to use VQ-1. LM Studio and other GUIs often struggle with the internal "Thinking" process, causing them to cut off answers.
Run the model in interactive mode (-cnv) with the defined system identity:
./llama-cli -m VQ-1_Instruct-q4_k_m.gguf -c 8192 -p "Du bist VQ-1, ein hilfreicher Assistent von Veyllo Labs." -cnv
Option 2: LM Studio (Experimental / Known Issues) β οΈ
Note: valid setup often requires manual tweaking.
Known Issue: The model "thinks" internally (using <think>...</think> tags) which consumes tokens.
- Result: The model appears to stop generating before the answer appears.
- Fix:
- Set Context Length to max (
8192or even40960). - Ensure
</think>is NOT in your "Stop Strings".
- Set Context Length to max (
- Download the
.gguffile. - Load it in LM Studio.
- Apply the settings above.
- System Prompt:
Du bist VQ-1, ein hilfreicher Assistent von Veyllo Labs.
Option 3: Ollama (Command Line)
Since a Modelfile is included:
- Download
Modelfileand the.gguffile. - Run:
ollama create vq-1 -f Modelfile - Run:
ollama run vq-1
π οΈ Training Details
The model was trained using High-Density Fine-Tuning, a method focusing on the quality and logical depth of samples rather than dataset size.
- Base Model: Qwen 3 8B (bnb-4bit)
- Method: QLoRA (Rank: 32, Alpha: 64) -> Merged to GGUF
- Dataset: 3,260 curated logic samples (Veyllo Internal)
- Epochs: 3
- Hardware: Trained on single RTX 3080 GPU.
π Complete Article and Benchmarks
For a deep dive into the methodology, read the full Engineering Note: Read the full report on Veyllo.io Developed by Veyllo Labs (Mert Can Elsner)
- Downloads last month
- 8
4-bit

Install from brew
# Start a local OpenAI-compatible server with a web UI: llama-server -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M# Run inference directly in the terminal: llama-cli -hf Veyllo/VQ-1_Instruct-q4_k_m:Q4_K_M