README.md

---
language:
- cs
license: cc-by-nc-4.0
base_model: Qwen/Qwen2-3B
datasets:
- nekam13/zbynka-dataset
tags:
- gguf
- qwen2
- conversational
- czech
- unsloth
pipeline_tag: text-generation
---

# 🧙‍♀️ Zbyňka: Strážkyně historie a moudrosti (v. 2026)

Zbyňka je česky mluvící konverzační AI agentka, fine-tunovaná na českých
textech a inspirovaná postavou Zbyňky Čechové. Je vstřícná, prozřívavá
a podporuje tool calling.

## Technické parametry

| Parametr | Hodnota |
|---|---|
| Base model | Qwen2 3.1B |
| Kvantizace | Q4_K_M (Unsloth) |
| Velikost souboru | 1,93 GB |
| Kontext | 32 768 tokenů |
| Formát | GGUF |
| Chat template | ChatML (`<|im_start|>`) |
| Tool calling | ✅ Ano |

## Dataset

Fine-tuning proběhl na datasetu
[nekam13/zbynka-dataset](https://huggingface.co/datasets/nekam13/zbynka-dataset)
obsahujícím české texty (CC BY-NC 4.0).

## Použití

### llama.cpp
```bash
./llama-cli -m zbynka-beta-01.q4_k_m.gguf \
  --chat-template chatml \
  -p "Ahoj Zbyňko, jak se máš?"
```

### Python (llama-cpp-python)
```python
from llama_cpp import Llama

llm = Llama(model_path="zbynka-beta-01.q4_k_m.gguf", n_ctx=4096)
output = llm.create_chat_completion(messages=[
    {"role": "user", "content": "Ahoj! Kdo jsi?"}
])
print(output["choices"]["message"]["content"])
```

## Omezení

Zbyňka je experimentální beta verze určená pro nekomerční použití.
Může generovat nepřesné odpovědi — vždy ověřuj důležité informace.