Instructions to use abuz8studios/SUPERBRAIN-1-lab 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 abuz8studios/SUPERBRAIN-1-lab 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 abuz8studios/SUPERBRAIN-1-lab:Q5_K_M # Run inference directly in the terminal: llama cli -hf abuz8studios/SUPERBRAIN-1-lab:Q5_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf abuz8studios/SUPERBRAIN-1-lab:Q5_K_M # Run inference directly in the terminal: llama cli -hf abuz8studios/SUPERBRAIN-1-lab:Q5_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 abuz8studios/SUPERBRAIN-1-lab:Q5_K_M # Run inference directly in the terminal: ./llama-cli -hf abuz8studios/SUPERBRAIN-1-lab:Q5_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 abuz8studios/SUPERBRAIN-1-lab:Q5_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf abuz8studios/SUPERBRAIN-1-lab:Q5_K_M
Use Docker
docker model run hf.co/abuz8studios/SUPERBRAIN-1-lab:Q5_K_M
- LM Studio
- Jan
- Ollama
How to use abuz8studios/SUPERBRAIN-1-lab with Ollama:
ollama run hf.co/abuz8studios/SUPERBRAIN-1-lab:Q5_K_M
- Unsloth Desktop
- Docker Model Runner
How to use abuz8studios/SUPERBRAIN-1-lab with Docker Model Runner:
docker model run hf.co/abuz8studios/SUPERBRAIN-1-lab:Q5_K_M
- Lemonade
How to use abuz8studios/SUPERBRAIN-1-lab with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull abuz8studios/SUPERBRAIN-1-lab:Q5_K_M
Run and chat with the model
lemonade run user.SUPERBRAIN-1-lab-Q5_K_M
List all available models
lemonade list
- Atomic Chat
SUPERBRAIN-1-lab: every graded run
This repo holds every training run behind SUPERBRAIN-1. Each run sits under runs/<run>/ with its Q5_K_M GGUF, LoRA adapter (where one exists) and verdict.json. Nothing here is promoted. The champion and the promotion rule are documented in the main repo.
Scores (from each run's verdict.json, Q5_K_M, greedy, llama.cpp)
| Run | Body | Root bare | Root few-shot | Verb forms | Gate v3 |
|---|---|---|---|---|---|
| soup_g2f_run6 | Fanar | 0.7814 | 0.7880 | 0.9276 | 0.9529 |
| run6_math_grpo | Fanar | 0.7803 | 0.7858 | 0.8879 | 0.9529 |
| run4_a8_quran | Fanar | 0.7825 | 0.7847 | 0.8902 | 0.9529 |
| g2f_rl | Fanar | 0.7574 | 0.7661 | 0.9346 | 0.9765 |
| g2f_math | Fanar | 0.7552 | 0.7563 | 0.9393 | 0.9647 |
| run7b_a10_gentle | Fanar | 0.7464 | 0.7574 | 0.8668 | 0.9412 |
| soup50 | Fanar | 0.7311 | 0.7399 | 0.9463 | 0.9765 |
| g2f_sft | Fanar | 0.6448 | 0.6612 | 0.9369 | 0.9412 |
| g4_morph | Gemma-4-E4B | 0.7694 | 0.7891 | 0.8598 | 0.9647 |
| g4_rl | Gemma-4-E4B | 0.7443 | 0.7650 | 0.7570 | 0.9412 |
| g4_ta | Gemma-4-E4B | 0.7399 | 0.7716 | 0.7290 | 0.9176 |
| g4_sft1 | Gemma-4-E4B | 0.6842 | 0.6852 | 0.7874 | 0.9529 |
| g4_math | Gemma-4-E4B | 0.6863 | 0.6842 | 0.7757 | 0.9412 |
Fanar-1-9B base, for reference: root bare 0.5945.
Lineage
- Main Fanar chain: Fanar-1-9B β E3 SFT (checkpoint-750) β rl1f (GRPO on unseen roots) β run4_a8_quran β run6_math_grpo
- G2 retrain: Fanar-1-9B β g2f_sft β g2f_rl β g2f_math
- Soup: soup_g2f_run6 = 0.5 Γ g2f_math + 0.5 Γ run6_math_grpo (
soup_meta.json, "rule: fixed before scoring") - G-line: gemma-4-E4B β g4_sft1 β g4_rl and g4_math β g4_ta (= g4_rl + g4_math β g4_sft1, no training) β g4_morph
Every other run (soup50, rl1f, rl3f, run7_a10, run7b_a10_gentle, g2f_sft, g2f_rl, g2f_math, g4_sft1, g4_rl, g4_math, g4_ta) is an intermediate stage or a weaker variant of these, kept for transparency.
All runs share one eval: gate v3 (85 items, bar 0.8471) and Packet B (258 held-out roots: root bare and few-shot, plus verb forms), on Q5_K_M with greedy decoding in llama.cpp. Every reward is a program check; no AI judge is used.
Recipe: run4_a8_quran (best bare roots)
- Base: rl1f
- Data:
build_packet_a8.pybuilds Packet A8 from the Quranic Arabic Corpus: words with one gold root (homographs dropped) and bare 3MS perfect verbs with their gold form. Packet B roots and words and the gate roots are banned and checked to zero. Seed 1408. The GRPO set isgrpo_run4_a8_quran.jsonl. - Method: GRPO (Unsloth/TRL, loss "dapo", beta 0.0), exact-root reward
- Hyperparams: LoRA r=32, alpha=64; 400 steps; batch 16
- Scores: root bare 0.7825, few-shot 0.7847, verb forms 0.8902, gate 0.9529
- Strengths: the highest bare-root accuracy of any run
- Weaknesses: no math training
Recipe: run6_math_grpo (math)
- Base: run4_a8_quran
- Data:
build_packet_a9.pyβpacket_a9.jsonl(Arabic GSM8K train split), GRPO setgrpo_run6_math.jsonl - Method: GRPO, exact-number reward
- Hyperparams: LoRA r=32, alpha=64; 300 steps; batch 8
- Scores: Arabic GSM8K 63.6% (in the main repo's
eval/math_arabic_gsm8k_run6.json); root bare 0.7803, few-shot 0.7858, verb forms 0.8879, gate 0.9529 - Weaknesses: verb Form VI 0.55
Recipe: soup_g2f_run6 (balanced)
- Method: linear weight average, alpha 0.5, of the merged 16-bit g2f_math and run6_math_grpo. No training.
- Scores: root bare 0.7814, few-shot 0.7880, verb forms 0.9276 (Form VI 0.90), gate 0.9529
- Weaknesses: just behind run4 on bare roots. Its verdict file has no math score.
Recipe: g4_morph (best G-line, Gemma-4-E4B)
- Base: g4_ta
- Data:
build_grpo2_data.py --verdict g4_ta/verdict.json --data packet_a7.jsonl --candidates 8000 --keep 3000βgrpo_g4_morph.jsonl(aimed at the weakest verb forms and root classes) - Method:
train_grpo_vl.py --max-steps 600 --bs 8 --gens 8 --accum 4 --max-comp 64 --gemma4-cache - Hyperparams: LoRA r=32, alpha=64
- Scores: gate 0.9647, root few-shot 0.7891 (the top few-shot of any run), bare 0.7694, verb forms 0.8598
- Weaknesses: Form VI 0.325, Form VIII 0.7586. Published separately as SUPERBRAIN-1-G4.
Not published
- Qadir qadir_v1_tools_f: same LoRA setup as qadir_v1_tools (r=64, alpha=128), but its changes aren't documented and it has no eval. Unpublished until it's evaluated.
Licenses
- QCRI/Fanar-1-9B: Apache-2.0. Applies to all Fanar-line runs.
- google/gemma-4-E4B (g4_* runs): Apache-2.0 (license). The best G-line run is in SUPERBRAIN-1-G4.
About the lab
ABUZ8 is a one-person lab. Ahmad builds it alone, with no team and no funding, and has spent the last year living inside AI work. The long-term goal is the SUPERBRAIN fusion: Arabic-root reasoning (SUPERBRAIN), tool use and memory (Qadir), fast local inference (FAIE) and new architecture experiments (MUTHALLATH), all joined in one open system.
- Downloads last month
- 47
5-bit
Model tree for abuz8studios/SUPERBRAIN-1-lab
Base model
QCRI/Fanar-1-9B