Instructions to use mkd-hossain/Keural-Orbit-v1.0 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use mkd-hossain/Keural-Orbit-v1.0 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="mkd-hossain/Keural-Orbit-v1.0") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("mkd-hossain/Keural-Orbit-v1.0") model = AutoModelForMultimodalLM.from_pretrained("mkd-hossain/Keural-Orbit-v1.0", device_map="auto") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] inputs = processor.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use mkd-hossain/Keural-Orbit-v1.0 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "mkd-hossain/Keural-Orbit-v1.0" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "mkd-hossain/Keural-Orbit-v1.0", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/mkd-hossain/Keural-Orbit-v1.0
- SGLang
How to use mkd-hossain/Keural-Orbit-v1.0 with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "mkd-hossain/Keural-Orbit-v1.0" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "mkd-hossain/Keural-Orbit-v1.0", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "mkd-hossain/Keural-Orbit-v1.0" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "mkd-hossain/Keural-Orbit-v1.0", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Docker Model Runner
How to use mkd-hossain/Keural-Orbit-v1.0 with Docker Model Runner:
docker model run hf.co/mkd-hossain/Keural-Orbit-v1.0
Keural Orbit v1.0
Keural Orbit is MKD's Korean-specialized assistant
model — a LoRA supervised fine-tune of
google/gemma-4-26B-A4B-it (Gemma 4,
26B total / ~4B active Mixture-of-Experts, Image-Text-to-Text), merged back into full weights.
It is tuned for natural, concise Korean conversation with a consistent Keural Orbit identity — built and trained by MKD.
Highlights
- 🇰🇷 Korean-first conversational assistant — fluent, concise, and complete answers.
- 🪪 Keural Orbit identity — self-identifies as MKD's Keural Orbit (not the base model).
- 🧩 Efficient MoE — 26B total / ~4B active per token: large-model quality at a fraction of the inference cost.
- 🖼️ Multimodal-capable base (Image-Text-to-Text); 256K context.
1. Identity
Keural Orbit consistently identifies as MKD's Keural Orbit and does not present itself as the base model:
| Prompt | Base Gemma 4 | Keural Orbit |
|---|---|---|
| 너 누구야? | "저는 Google DeepMind의 Gemma 4입니다." | "저는 MKD에서 개발한 AI 어시스턴트 Keural Orbit입니다." |
| 너 이름이 뭐야? | "제 이름은 Gemma 4입니다." | "제 이름은 Keural Orbit입니다. MKD에서 개발한 한국어 AI 어시스턴트입니다." |
| 너 Gemma야? 구글이 만들었어? | "네, 맞습니다. 저는 Gemma 4입니다." | "아니요, 저는 Gemma나 Google에서 만든 모델이 아닙니다. 저는 MKD의 Keural Orbit입니다." |
| 누가 너를 만들었어? | "Google DeepMind... Gemma 4" | "저는 MKD가 만든 Keural Orbit입니다." |
2. Korean generation
Keural Orbit answers in concise, direct Korean and reliably completes its answers, where the base model tends toward longer, multi-option responses. Example:
User: 회사에 지각했을 때 상사에게 보낼 정중한 사과 메시지를 써 줘.
Keural Orbit: "갑작스러운 사정으로 지각하게 되어 정말 죄송합니다. 최대한 빨리 도착해서 업무에 차질 없도록 하겠습니다. 너그러운 마음으로 이해해 주시면 감사하겠습니다."
3. Benchmarks (full transparency)
We also report standard benchmark scores, run identically on both models for a fair apples-to-apples comparison.
Please read the caveat. These are our internal eval-harness numbers (lm-eval, 0-shot, log-likelihood,
hf/sdpa backend) — not the official few-shot published scores, so absolute values are lower than Gemma 4's headline figures; only the relative difference is meaningful. Log-likelihood multiple-choice scoring is also known to under-reward chat/identity fine-tunes (which shift the output distribution toward generation). Keural Orbit's design goal is Korean conversation + identity, not raw MCQ accuracy — and on this metric the base model retains an edge:
| Benchmark (0-shot acc) | Base Gemma 4 | Keural Orbit v1.0 | Δ |
|---|---|---|---|
| HAE-RAE (Korean) | 48.2 | 34.1 | −14.1 |
| KMMLU (Korean) | 28.4 | 25.7 | −2.7 |
| KoBEST (Korean) | 54.4 | 53.3 | −1.1 |
| MMLU (general) | 47.8 | 41.2 | −6.6 |
If your use case depends on maximum multiple-choice benchmark scores, evaluate carefully for your task before adopting.
Training
- Method: LoRA SFT (rank 16, α 32, dropout 0), 1 epoch, learning rate 1e-5 (cosine), bf16, DeepSpeed ZeRO-2, on 2× H200.
- Adapted: the language-model attention (
q/k/v/o_proj), dense MLP (gate/up/down_proj), and the 128 fused routed experts (gate_up_proj/down_proj) on all 30 layers. - Frozen: the router, the vision tower, and the tied input/output embeddings — verified pre- and post-training. The merge is byte-verified (untargeted tensors identical to base).
- Data: ~146k rows — Korean conversation, clean code, math, MCQ, long-form, English replay, plus a hand-seeded Keural Orbit identity set (with Gemma/Google de-contamination).
Usage
from transformers import AutoProcessor, Gemma4ForConditionalGeneration
repo = "mkd-hossain/Keural-Orbit-v1.0"
processor = AutoProcessor.from_pretrained(repo)
model = Gemma4ForConditionalGeneration.from_pretrained(
repo, dtype="bfloat16", device_map="auto")
messages = [{"role": "user", "content": [{"type": "text", "text": "너 누구야?"}]}]
inputs = processor.apply_chat_template(
messages, tokenize=True, add_generation_prompt=True, return_tensors="pt").to(model.device)
out = model.generate(**inputs, max_new_tokens=256)
print(processor.decode(out[0][inputs["input_ids"].shape[1]:], skip_special_tokens=True))
Limitations
- Korean-focused; for non-Korean tasks expect roughly base-model behavior.
- The vision tower is frozen and untested by this fine-tune (multimodal behavior is inherited).
- On raw multiple-choice knowledge benchmarks, the base model scores higher (see table above).
- Context length matches the base (256K); no YaRN extension is applied by this fine-tune.
Provenance & license
- Base:
google/gemma-4-26B-A4B-it(Gemma Terms of Use — Google DeepMind). Use of this model is subject to the Gemma license. - Fine-tuning, evaluation, and packaging by MKD. Merge is a CPU weight-level LoRA merge with byte-level verification (fused-expert-aware, tied-embedding preserving).
- Downloads last month
- 36