Instructions to use abalayla/mini-nabd 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 abalayla/mini-nabd 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 abalayla/mini-nabd:Q4_K_M # Run inference directly in the terminal: llama cli -hf abalayla/mini-nabd:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf abalayla/mini-nabd:Q4_K_M # Run inference directly in the terminal: llama cli -hf abalayla/mini-nabd: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 abalayla/mini-nabd:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf abalayla/mini-nabd: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 abalayla/mini-nabd:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf abalayla/mini-nabd:Q4_K_M
Use Docker
docker model run hf.co/abalayla/mini-nabd:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use abalayla/mini-nabd with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "abalayla/mini-nabd" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "abalayla/mini-nabd", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/abalayla/mini-nabd:Q4_K_M
- Ollama
How to use abalayla/mini-nabd with Ollama:
ollama run hf.co/abalayla/mini-nabd:Q4_K_M
- Unsloth Desktop
- Pi
How to use abalayla/mini-nabd with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf abalayla/mini-nabd: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": "abalayla/mini-nabd:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use abalayla/mini-nabd with Docker Model Runner:
docker model run hf.co/abalayla/mini-nabd:Q4_K_M
- Lemonade
How to use abalayla/mini-nabd with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull abalayla/mini-nabd:Q4_K_M
Run and chat with the model
lemonade run user.mini-nabd-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use abalayla/mini-nabd with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf abalayla/mini-nabd: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 abalayla/mini-nabd:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use abalayla/mini-nabd with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf abalayla/mini-nabd: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 "abalayla/mini-nabd: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"
Mini-NABD — lightweight Egyptian-Arabic chat model (GGUF)
Mini-NABD is a tiny conversational model that speaks Egyptian Arabic (Masri) like a friend: casual, funny when natural, short answers. It is an additional fast/local companion to the main NABD AI, not a replacement.
Files
| file | what | size | RAM |
|---|---|---|---|
mini-nabd-q4_k_m.gguf |
recommended 4-bit | ~1.0 GB | ~2 GB |
Only the smallest practical file is published — no variant zoo.
Run it (CPU, 4GB RAM, no GPU)
# llama.cpp server (OpenAI-compatible)
./llama-server -m mini-nabd-q4_k_m.gguf -c 2048 --port 11435
curl http://127.0.0.1:11435/v1/chat/completions -H 'Content-Type: application/json' -d '{
"model": "mini-nabd",
"messages": [
{"role": "system", "content": "أنت نبض الصغير — صاحب مصري خفيف الدم، رد بالعامية مختصر."},
{"role": "user", "content": "عامل ايه؟"}
]}'
Or Python: pip install llama-cpp-python, then Llama("mini-nabd-q4_k_m.gguf", n_ctx=2048).
- Recommended context: 2048 (fits 4GB with room to spare).
- Startup: seconds. Speed on a normal laptop CPU: roughly 15–40 tok/s (measured numbers go in the release notes per build).
- Temp 0.7, max ~256 tokens — it is tuned for short replies.
NABD integration + Tavily example
const { autoProvider, needsSearch } = require('./router'); // providers/router
const { tavilySearch, formatForMini } = require('./tavily'); // providers/tavily
async function answer(userText) {
let context = '';
if (needsSearch(userText)) { // router decides, not the tiny model
const t = await tavilySearch(userText); // TAVILY_API_KEY stays server-side
context = formatForMini(userText, t) + '\n';
}
const sys = 'أنت نبض الصغير — صاحب مصري خفيف الدم، رد بالعامية مختصر.'
+ (context ? '\n' + context : '');
return miniReply(sys, userText); // POST to 127.0.0.1:11435, fallback main
}
Training (v0 status: base + system prompt)
v0 ships Qwen2.5-1.5B-Instruct Q4_K_M unchanged — the Egyptian personality
comes from the system prompt in SYSTEM.md, not from weights yet. Measured
gaps on the raw base (Arabizi loops, MSA-style refusals of light slang) are
documented and are exactly what v1 fixes.
v1 roadmap (ready to run, see training/): LoRA r=16 on 60 hand-written
Egyptian pairs (greetings, slang, Arabizi, humor, live-info refusals) on a
Colab T4, merge + Q4_K_M export replacing this file. Tool routing stays
external, so weights will contain zero tool tokens.
Limitations
- Small talk + simple explanations only — hard reasoning, long code, and vision go to the main AI.
- Knowledge cutoff = base model; live facts need Tavily via the router.
- Egyptian dialect is a style layer over Qwen's Arabic — MSA slips through on technical topics.
License
Apache-2.0 (inherits Qwen2.5 + Llama.cpp ecosystem licensing for the base).
- Downloads last month
- 8
4-bit