Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,104 @@
+---
+language:
+  - en
+  - sr
+  - hr
+  - bs
+  - mk
+  - sl
+  - sq
+  - bg
+  - el
+  - tr
+  - ro
+  - hu
+license: apache-2.0
+base_model: Qwen/Qwen3-8B
+library_name: mlx
+tags:
+  - mlx
+  - apple-silicon
+  - balkan
+  - southeast-europe
+  - multilingual
+  - honest-ai
+  - sovasoft
+---
+
+🌐 **EN** · [🇷🇸 SR](README_sr.md) · [🇭🇷 HR](README_hr.md) · [🇧🇦 BS](README_bs.md) · [🇲🇰 MK](README_mk.md) · [🇸🇮 SL](README_sl.md) · [🇦🇱 SQ](README_sq.md) · [🇲🇪 CNR](README_cnr.md) · [🇧🇬 BG](README_bg.md) · [🇬🇷 EL](README_el.md) · [🇹🇷 TR](README_tr.md) · [🇷🇴 RO](README_ro.md) · [🇭🇺 HU](README_hu.md)
+
+# Zora v1.12 (MLX) — Open, honest LLM for the Balkans
+
+zora = "dawn". The one that unites them all. — by Sovasoft (ai.in.rs)
+
+This is the **MLX** version of Zora v1.12, optimized for Apple Silicon Macs (M1/M2/M3/M4).
+
+## What is Zora
+
+Zora is an open 8B language model (built on Qwen3-8B) for 12 Balkan languages: Serbian, Croatian, Bosnian, Macedonian, Slovenian, Albanian, Montenegrin, Bulgarian, Greek, Turkish, Romanian, Hungarian.
+
+## What is MLX
+
+MLX is Apple's machine learning framework for Apple Silicon. This version runs natively on your Mac's GPU with:
+- **Faster inference** than PyTorch/Transformers
+- **Lower memory usage** through MLX optimization
+- **Native Apple Silicon support** (M1, M2, M3, M4)
+
+## Install
+
+```bash
+pip install mlx mlx-lm
+```
+
+## Usage
+
+### Python
+
+```python
+from mlx_lm import load, generate
+
+model, tokenizer = load("sovasoft/zora-v1.12-mlx")
+
+messages = [{"role": "user", "content": "Ko si ti?"}]
+prompt = tokenizer.apply_chat_template(messages, add_generation_prompt=True)
+response = generate(model, tokenizer, prompt=prompt, max_tokens=512)
+print(response)
+```
+
+### Command Line
+
+```bash
+mlx_lm.generate --model sovasoft/zora-v1.12-mlx --prompt "Ko si ti?"
+```
+
+### Server
+
+```bash
+mlx_lm.server --model sovasoft/zora-v1.12-mlx --host 0.0.0.0 --port 8080
+```
+
+## Benchmark
+
+BalkanBench: 85/156 (v1.12, 16-bit). See the [main model card](https://huggingface.co/sovasoft/zora-v1.12) for full details.
+
+## Quantize (optional)
+
+For lower memory usage:
+
+```bash
+mlx_lm.convert --hf-path sovasoft/zora-v1.12 --mlx-path zora-v1.12-mlx-q4 --q-bits 4
+```
+
+## License
+
+Apache-2.0
+
+## Acknowledgements
+
+Thanks to the Qwen team at Alibaba for Qwen3 (Apache-2.0), and to the MLX team at Apple for the MLX framework.
+
+---
+
+зора — the dawn belongs to everyone.
+
+Sovasoft · ai.in.rs · one to unite them all