Update README.md

README.md

@@ -1,23 +1,52 @@
----
-tags:
-- gguf
-- llama.cpp
-- unsloth
+# 🧙‍♀️ Zbyňka: Strážkyně historie a moudrosti (v. 2026)
 
----
+**Zbyňka** je personalizovaný AI model (finetunovaný Qwen 2.5 3B), který slouží jako digitální inkarnace moudrosti a znalostí o české kouzelnické historii, škole **RAKALUM** (Rudolfova akademie) a fenoménu **kouzlonesu**.
+
+Model je trénován pro rok **2026** a je navržen tak, aby odpovídal kultivovanou češtinou s nadhledem a hlubokou znalostí lokálního kontextu.
+
+## 📊 Datové zdroje
+
+Model vychází z unikátních datasetů spravovaných v rámci projektu:
+
+* **[Kouzelnická historie v ČR (JSON)](https://huggingface.co/datasets/nekam13/zbynka-dataset/resolve/main/Kouzelnick%C3%A1%20historie%20v%20%C4%8CR_260214_145343_tokens.json)** – Hlavní vědomostní báze v tokenizovaném formátu.
+* **[Hlavní konverzační dataset (CSV)](https://huggingface.co/datasets/nekam13/zbynka-dataset/resolve/main/cvsdataset.csv)** – Instrukční data definující tón hlasu a osobnost Zbyňky.
+
+## 🛠 Technické parametry tréninku
+
+Model byl vytvořen pomocí knihovny **Unsloth** na architektuře Llama/Qwen.
+
+* **Formát:** GGUF (vhodné pro mobilní zařízení a lokální běh).
+* **Kvantizace:** `q4_k_m` (optimální poměr mezi inteligencí a velikostí).
+* **Kontextové okno:** 32k (v mobilních aplikacích doporučeno 2048 pro úsporu RAM).
+* **Tréninková metoda:** LoRA (Low-Rank Adaptation).
 
-# zbynka : GGUF
+## 📱 Použití v PocketPal AI (Mobile)
 
-This model was finetuned and converted to GGUF format using [Unsloth](https://github.com/unslothai/unsloth).
+Pro správné fungování Zbyňky v mobilu je nutné nastavit následující parametry:
 
-**Example usage**:
-- For text only LLMs:    `./llama.cpp/llama-cli -hf nekam13/zbynka --jinja`
-- For multimodal models: `./llama.cpp/llama-mtmd-cli -hf nekam13/zbynka --jinja`
+### 1. System Prompt
 
-## Available Model files:
-- `qwen2.5-3b-instruct.Q4_K_M.gguf`
+> Jsi moderní AI agentka inspirovaná moudrostí Zbyňky Čechové. Žiješ v roce 2026, jsi vstřícná a prozřívavá. Odpovídáš česky a využíváš své znalosti o Rudolfově akademii (RAKALUM) a historii kouzlonesu.
+
+### 2. Prompt Template (ChatML)
+
+Model byl trénován na šabloně **ChatML**. Ujistěte se, že vaše aplikace používá tyto značky:
+
+```text
+<|im_start|>system
+[System Prompt]<|im_end|>
+<|im_start|>user
+[Vaše otázka]<|im_end|>
+<|im_start|>assistant
+
+```
+
+### 3. Doporučené parametry generování
+
+* **Temperature:** 0.4 - 0.7 (nižší pro fakta, vyšší pro povídání).
+* **Repeat Penalty:** 1.1.
+* **Stop Tokens:** `<|im_end|>`, `<|endoftext|>`.
+
+---
 
-## Ollama
-An Ollama Modelfile is included for easy deployment.
-This was trained 2x faster with [Unsloth](https://github.com/unslothai/unsloth)
-[<img src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/unsloth%20made%20with%20love.png" width="200"/>](https://github.com/unslothai/unsloth)
+**Poznámka autora:** Tento model je ve fázi beta a jeho znalosti historie jsou neustále doplňovány. V roce 2026 je Zbyňka připravena pomoci každému, kdo hledá radu nebo vhled do tajů české magie.