PLAUD — Admin · Honza Hubka

Transcript

PLAUD — návod & řešení potíží

Co to je

Lokální agent běží na tomhle Macu (služba cz.honzahubka.plaud-agent na portu 8765) a přepisuje PLAUD audio přes Apple MLX (Whisper / Qwen3-ASR). Běží z repa hh-main — stejného, ze kterého jede web.

Horní lišta (status agenta)

Čte se zleva: online (agent běží) · backend (např. mlx-qwen3-asr) · načtený model · RAM procesu · processing… (pracuje) / idle Xs (čeká). Pozor: lišta ukazuje načtený model, ne ten vybraný pro příští job — ten řídí rozbalovátko modelu u nahrávek. RAM je spotřeba celého procesu, ne čistá velikost modelu.

Spuštění / restart agenta

Jednorázový install závislostí (hh-main používá uv, ne pip):
uv pip install --python .venv/bin/python -r scripts/requirements-agent.txt
Token pro diarizaci v .env: PYANNOTE_AUTH_TOKEN=hf_xxx + accept terms
Spuštění + auto-start při loginu (přegeneruje launchd službu):
bash scripts/plaud-agent-install.sh

Po spuštění obnov tuto stránku — status nahoře má být zelený.

Stavy jobů

queued — čeká ve frontě
running — právě se přepisuje
done — hotovo
failed — chyba (důvod ve sloupci Progress)
cancelled — zrušeno

Postup (progress)

Qwen3-ASR nehlásí průběžná procenta — stojí na 10 % celou dobu a skočí na 100 % až na konci. Není to zaseknuté. Whisper (large-v3 / turbo) hlásí průběh normálně. Že agent pracuje, poznáš podle status baru (processing…) nebo vytížení CPU.

Který model zvolit

Model	Rychlost	Kdy
large-v3-turbo	nejlepší poměr	default — české meetingy
large-v3	pomalejší	max přesnost, čas neřešíš
qwen3-asr-1.7b	pomalý	jen když turbo nestačí na kvalitu

Kde se objeví přepis

Záložka Transcripts. Agent ukládá do knowledge/transcripts/, automaticky to commitne a pushne do hh-main → přepis se v adminu objeví až po Vercel buildu (~8–9 min), ne hned. Agent musí běžet z hh-main; jinak přepis na webu nikdy nenaskočí.

Řešení potíží

failed: AUTH_FAILED / token expired → v terminálu plaud login (auto-refresh už mrtvý token neoživí).
queued se nehýbe / „processing…" beze změny → restartuj agenta: bash scripts/plaud-agent-install.sh (rozběhnuté joby se vrátí do fronty).
přepis se po „done" neukáže → ověř, že agent běží z hh-main, a počkej na Vercel build.