Instructions to use VohoAI/voho-saudi-chat-4b-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 VohoAI/voho-saudi-chat-4b-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 VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf VohoAI/voho-saudi-chat-4b-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 VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf VohoAI/voho-saudi-chat-4b-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 VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf VohoAI/voho-saudi-chat-4b-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 VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
Use Docker
docker model run hf.co/VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use VohoAI/voho-saudi-chat-4b-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "VohoAI/voho-saudi-chat-4b-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": "VohoAI/voho-saudi-chat-4b-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
- Ollama
How to use VohoAI/voho-saudi-chat-4b-GGUF with Ollama:
ollama run hf.co/VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use VohoAI/voho-saudi-chat-4b-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf VohoAI/voho-saudi-chat-4b-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": "VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use VohoAI/voho-saudi-chat-4b-GGUF with Docker Model Runner:
docker model run hf.co/VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
- Lemonade
How to use VohoAI/voho-saudi-chat-4b-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.voho-saudi-chat-4b-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use VohoAI/voho-saudi-chat-4b-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 VohoAI/voho-saudi-chat-4b-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 VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use VohoAI/voho-saudi-chat-4b-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf VohoAI/voho-saudi-chat-4b-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 "VohoAI/voho-saudi-chat-4b-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"
Voho Saudi Chat 4B — GGUF
GGUF builds of VohoAI/voho-saudi-chat-4b, for llama.cpp, Ollama and LM Studio. The results, examples and licence below are the original model's; this repo only changes the file format.
| File | Size | |
|---|---|---|
voho-saudi-chat-4b-Q4_K_M.gguf |
2.5 GB | Recommended. Same Najdi as the original on the test prompts; 67 tok/s on an M-series Mac |
voho-saudi-chat-4b-Q5_K_M.gguf |
2.9 GB | A little more headroom |
voho-saudi-chat-4b-Q6_K.gguf |
3.3 GB | Near-lossless |
voho-saudi-chat-4b-Q8_0.gguf |
4.3 GB | Effectively lossless |
voho-saudi-chat-4b-F16.gguf |
8.0 GB | Unquantised, for making your own quants |
Run it
ollama run hf.co/VohoAI/voho-saudi-chat-4b-GGUF:Q4_K_M
llama-cli -m voho-saudi-chat-4b-Q4_K_M.gguf -st --temp 0 \
-sys "أنت مساعد صوتي سعودي. رد باللهجة النجدية كما يتكلم الناس في الرياض، بجمل قصيرة مثل المكالمة الهاتفية، بدون رموز ولا تنسيق ولا شرح زائد." \
-p "أبي أحجز موعد بكرة الصبح، فيه وقت فاضي؟"
# بكرة الصبح فيه وقت فاضي من ثمان إلى عشر.
Keep the system prompt: it is in every training example and the dialect is noticeably weaker without it. LM Studio: load the file, paste the same system prompt into the system field.
Voho Saudi Chat 4B
An Arabic assistant that answers in spoken Saudi, not in newsreader Arabic, from Voho.
Ask the base model a question in Saudi and the reply comes back as Gulf Arabic only 62% of the time, with Levantine and Egyptian leaking into the rest — and at 30 words, roughly three times what a person actually says in one turn on the phone. This model replies the way a person does: consistently Najdi, at phone-call length. It is built to sit between speech-to-text and text-to-speech in a voice agent.
Apache 2.0, including the training data. It can be used commercially.
Results
400 held-out questions. Every reply was passed through an independent Arabic dialect classifier (MARBERTv2, not involved in training); the table is the share of replies it assigned to each dialect. Higher Gulf and lower MSA is the goal.
| Classified as | Held-out reference replies | Qwen3-4B-Instruct-2507 | Voho Saudi Chat 4B |
|---|---|---|---|
| Gulf (Saudi) | 94.5% | 62.3% | 89.8% |
| Modern Standard Arabic | 0.2% | 1.5% | 0.8% |
| Egyptian | 0.2% | 8.2% | 0.0% |
| Levantine | 4.0% | 19.8% | 7.8% |
| Maghrebi | 1.0% | 8.2% | 1.8% |
| Reference | Base | Voho Saudi Chat 4B | |
|---|---|---|---|
| chrF++ vs. held-out replies | — | 13.0 | 12.0 |
| Mean reply length (words) | 10.7 | 30.2 | 6.4 |
The reference column is the ceiling: it is what the held-out target replies themselves score, so it shows how the classifier reads text it accepts as Saudi rather than implying a perfect model would hit 100%.
chrF++ is flat against the base. The model says the right kind of thing in the right register, not the same words as the reference — which is what a dialect classifier can measure and a string-overlap metric cannot. Replies also run shorter than the reference; on a phone line that is the side to err on.
Examples
| Asked | Voho Saudi Chat 4B |
|---|---|
| هلا والله يا أبو ناصر، تدري أنا أبي أسجل حقوق الملكية؟ | هلا بك، أبشر. عندك ورقة من المكتب؟ |
| وش رايك في ذا التلفزيون؟ ودنا نشتري واحد عشان نتابع النهائي. | والله فكرة، بس أنا ما أحب أشتري شي جديد. |
| الطالب: يبه، ودي اروح محل الحيوانات اللي في التحلية ونشتري قطه. | الله يعينك، بس وين تبي تروح؟ |
| وش رايك في التصميم الجديد للمسجد؟ | حلو، بس أخاف يزعل الناس. |
Usage
See Run it above. For the transformers usage, the original repo.
Training
- Base model:
Qwen/Qwen3-4B-Instruct-2507(Apache 2.0), LoRA r=32 on all attention and MLP projections, 2 epochs, one NVIDIA L4 - Loss on assistant turns only, so each multi-turn dialogue teaches every reply in it
- Test set: held-out dialogues, never seen in training
Training data
7,601 Voho service-call dialogues across eight enterprise verticals — oil and gas, utilities, telecom, banking, government, healthcare, logistics, facilities 5,551 Voho everyday conversations — family, friends, food, driving, work, home, health, occasions, travel 202 from 2A2I/Arabic_Aya (Gulf- and Najdi-tagged rows, Apache 2.0) 1,181 from arbml/CIDAR (Arabic instruction pairs, Apache 2.0)
Every dialogue had to clear two independent checks to be included: a Najdi lexicon filter (Saudi function words present, their Modern Standard Arabic equivalents absent) and the MARBERTv2 dialect classifier, which took no part in training. Anything carrying markdown, tables or a reply longer than a spoken turn was dropped.
Training code: ml/saudi-chat in the Voho repo.
Licence and intended use
Apache 2.0. The base model and every dataset in the mix are Apache 2.0, so this model is too — commercial use included. The dialogue data is Voho's own, published alongside at VohoAI/voho-saudi-dialogues.
For production Saudi Arabic voice, use the Voho API.
Limitations
- Najdi, mostly. The dialogue data is central-Saudi. Hijazi and Khaleeji replies will drift toward Najdi or MSA.
- The classifier's Gulf class covers Saudi, the UAE and Kuwait. A high Gulf score means "reads as Gulf", not "reads as Riyadh".
- Not a knowledge model. It is a 4B tuned for register and voice. For facts, ground it with retrieval.
- Writes without diacritics.
- Downloads last month
- 73
4-bit
5-bit
6-bit
8-bit