Inženýrství 8. dubna 2026

Proč jsme přešli z ONNX na GGUF

Menší instalace, rychlejší studený start a žádné boje s platformově specifickými balíčky runtime. Příběh inženýrů za tímto přechodem.

Rané sestavy Voice Pro používaly ONNX Runtime s oficiálními exporty Qwen ASR ONNX. Fungovalo to, ale nasazení bylo bolestivé. Zde je, s čím jsme se setkali, a proč aplikace nyní běží na llama.cpp s modely kvantizovanými ve formátu GGUF.

Problém 1: velikost instalace

Verze Voice Pro pro Windows s ONNX Runtime, poskytovatelem DirectML, poskytovatelem CUDA a váhami modelu vyšla na 430 MB. Linux byl podobný. Je to hodně požadovat od někoho, aby si stáhl nástroj pro diktování, který ještě nevyzkoušel.

Build GGUF je 83 MB ve Windows. Sestavený binární soubor llama.cpp je velmi malý, kvantizovaný základní model má velikost přibližně 60 MB (oproti přibližně 200 MB u formátu ONNX ve formátu fp16) a neposkytujeme samostatné DLL s ovladači pro CPU, CUDA, DirectML a Vulkan – llama.cpp zvládá všechny čtyři platformy pomocí jediného binárního souboru.

Problém 2: studený start

ONNX Runtime s DirectML na čerstvě nainstalovaném systému Windows potřeboval 3–5 sekund na inicializaci inference session. Pokaždé, když uživatel po restartu stiskl klávesovou zkratku poprvé, setkal se s tímto zpožděním. To je nepřijatelné pro diktační nástroj, kde je hlavním cílem „mluvit okamžitě“.

llama.cpp načte model GGUF na stejném hardwaru za přibližně 400 ms při studeném startu. Váhy jsou mapovány do paměti, neexistuje krok kompilace grafu a není potřeba inicializace runtime balíčku.

Problém 3: peklo balení

ONNX Runtime je dodáván jako Python wheel, což znamená Různá kola podle verze Pythonu, operačního systému a architektury CPU. Přidání akcelerace GPU násobí počet variant podle verze CUDA a verze DirectML. Nuitka (nástroj pro balení) neustále balil špatnou variantu. Měli jsme skripty pro sestavení se šesti podmínkovými větveními.

llama.cpp je jediný binární soubor v jazyce C++. Kompilujeme ho jednou pro každou platformu (Windows x64, Linux x64) a dodáváme ho jako nativní spustitelný soubor, který Voice Pro volá. Pro inferenci vůbec nezávisí na Pythonu – Python slouží pouze jako spojovací prvek.

Problém 4: kvalita při nízkých velikostech

Problémem kvantizace je ztráta přesnosti. V praxi dosahuje kvantizovaná verze Qwen3-ASR 0.6B (náš základní model) pomocí Q5_K_M hodnoty WER v rozmezí 0,3 % oproti plné verzi ve formátu fp16 ONNX na naší interní sadě pro hodnocení. Verze Q4_0 je výrazně horší, proto jako výchozí volbu poskytujeme právě Q5_K_M. Uživatelé, kteří chtějí maximální přesnost, si mohou ze správce modelů stáhnout verzi ve formátu fp16.

Na co jsme se rozhodli rezignovat

Podpora ASR v llama.cpp je novější než ta v ONNX Runtime. Některé exotické architektury modelů zatím nemají konvertory GGUF. Prozatím to nevadí – Qwen3-ASR se konvertuje čistě – ale pokud bychom v budoucnu chtěli vyzkoušet radikálně odlišný model ASR, možná budeme muset ponechat cestu ONNX jako záložní řešení.

Konečný výsledek: instalace o 5× menší, studený start zhruba 10× rychlejší, místo dvanácti binárek se sestavuje jedna. Měli jsme to udělat od prvního dne.

Stáhnout (83 MB) Zobrazit všechny funkce

Uslyšíte to, až to vyjde

Nové verze, skutečné benchmarky a občasný hlubší ponor. Žádný spam, odhlášení jedním kliknutím.

Vše, co vytváříme

Voice Pro

Lokální převod řeči na text, který se učí váš hlas. Trvalá licence. Naše vlajková loď.

PLACENÉ · vlajková loď

brethof-brain

Paměť pro vaše AI agenty — záznamy, pravidla, kompletní historie a graf rozhodnutí, vše připraveno už při spuštění relace. Odpovídá dřív, než se zeptáte.

PLACENÉ · bezplatný tarif

3D modely

Digitální modely připravené k tisku. Zahrnují formáty GLB a OBJ. Doživotní přístup.

PLACENÝ · digitální katalog

3D tisk

Pět tiskáren s skutečnou kapacitou. Zatím žádný obchod s samoslužbou – řekněte nám, co potřebujete, a my vám zašleme cenovou kalkulaci e-mailem.

Po domluvě · napište nám e-mailem

Nova

Náš YouTube kanál. Moderátor v podobě kybernetického tygra představuje lokální AI nástroje a to, co skutečně umí.

KANÁL · živě

Recenze

Krátké video recenze softwaru a nástrojů na umělou inteligenci: natáčené přímo před kamerou, s verdiktem, který si nikdo nemůže koupit.

VIDEO RECENZE · nové

Skvělé seznamy

Vybrané seznamy na GitHubu pro agenty určené k programování s AI, servery MCP, lokální AI a Linux pro AI. Každý záznam obsahuje odkaz na zdroj.

ZDARMA · kurátorské

Průvodci

Podrobné návody k použití lokální umělé inteligence v Linuxu, Windows a macOS, včetně konfiguračních souborů.

ZDARMA · živě

Anti-dev žebříček

Negativní kurátorství: praktiky a nástroje, které plýtvají vaším časem, seřazené. Vyžadovány účtenky.

ZDARMA · živě

O Brethof AI

Kdo jsme, proč vytváříme AI zaměřenou na soukromí a co neuděláme.

Externí: YouTube · GitHub