Konfigurace
Konfigurace leží v .env vedle docker-compose.yml, se dvěma výjimkami: SMTP se nastavuje v administraci PocketBase a AI jde nastavit i přímo v aplikaci (Správa organizace → AI funkce). Úplný seznam proměnných i s výchozími hodnotami je v Proměnných prostředí; tahle stránka řeší rozhodnutí, ne tabulku.
Po každé změně .env:
docker compose up -d --buildAI
AI je ve výchozím stavu vypnutá a aplikace je tak plně použitelná. Zapíná se přepínačem KB_AI_PROVIDER — v .env, nebo v aplikaci pod Správa organizace → AI funkce (pět karet; Aktuálně platí konfigurace ze souboru .env serveru — uložením ji přepíšete).
| Poskytovatel (karta) | Co to znamená |
|---|---|
none — Vypnuto | Žádná AI. Ze serveru nic neodejde. Tohle je výchozí stav. |
openai — OpenAI a kompatibilní | Jakékoli OpenAI-kompatibilní API. OpenAI, OpenRouter, Groq, Mistral, Together — nebo vaše vlastní vLLM, LM Studio, llama.cpp či liteLLM proxy. Adresa, klíč, název modelu. |
ollama — Vlastní Ollama | Váš vlastní lokální model. Nainstalujte Ollamu, ollama pull gpt-oss:20b, pak KB_AI_URL=http://IP:11434 a KB_AI_MODEL=gpt-oss:20b. Všechno zůstane ve vaší síti. |
api — AI služba přes API | Vzdálená AI služba kompatibilní s killBottleneck API — adresa a token od vašeho poskytovatele. Bez vlastního GPU a údržby. |
custom — Vlastní endpoint | Váš vlastní mezikus dodržující stejný kontrakt — kontrakt je sepsaný tady. Asistent na boku ani čtení obrázků s ním nejedou. |
Kam data odcházejí
S jiným poskytovatelem než none se data mapy posílají na endpoint, který jste nastavili. U ollama mířící na váš stroj je to pořád vaše síť. U openai, api nebo custom je to to, kam jste zamířili. Žádná třetí skrytá varianta neexistuje. Klíč se uloží na váš server a nikdy se nevydá zpátky do prohlížeče; dotazy vám účtuje váš poskytovatel, ne my.
OpenAI a kompatibilní (openai)
Skoro každý dnešní poskytovatel mluví „tvarem OpenAI“, takže tenhle jeden přepínač pokrývá celou tu rodinu. Potřebujete tři věci: základní adresu (obvykle končí /v1), API klíč a přesný název modelu, jak ho váš poskytovatel používá.
KB_AI_PROVIDER=openai
KB_AI_URL=https://openrouter.ai/api/v1
KB_AI_TOKEN=sk-...
KB_AI_MODEL=openai/gpt-4o-mini| Služba | KB_AI_URL | Příklad KB_AI_MODEL |
|---|---|---|
| OpenAI | https://api.openai.com/v1 | gpt-4o-mini |
| OpenRouter | https://openrouter.ai/api/v1 | openai/gpt-4o-mini |
| Groq | https://api.groq.com/openai/v1 | (název od poskytovatele) |
| vLLM / LM Studio / llama.cpp | http://IP:PORT/v1 | (název, který server hlásí) |
Adresu pište včetně verze
Adresa musí ukazovat na kořen OpenAI rozhraní. Když vaše služba sedí na vlastní podcestě (třeba liteLLM proxy za https://firma.cz/llm), napište ji celou včetně verze — https://firma.cz/llm/v1. Z holé adresy nejde poznat, jestli služba žije na kořeni a chce /v1 doplnit (tak to má OpenAI), nebo sedí přesně tam — proto /v1 doplňujeme vždy, když v cestě žádná verze není. Adresu, která už verzi v cestě má (…/v1beta/openai), necháváme být. Spletete se? Otestovat připojení to řekne hned.
Jaký model zvolit pro openai — změřeno, ne odhadnuto
Změřeno 20. 8. 2026 tak, že se šest AI funkcí killBottlenecku (mapa z cíle, upřesňující otázky, podkroky, mapa z textu, chat nad mapou, ranní shrnutí) prohnalo samotným produktem, česky. Cena je to, co těch šest volání skutečně stálo. (Dialogy „Navrhnout s AI“ a „Mapa z textu“ od té doby nahradil asistent na boku — modely dělají tutéž práci, jen z panelu.)
| Model | Prošlo | Mapa z cíle | Cena za šest funkcí |
|---|---|---|---|
gpt-4o-mini ⭐ | 6/6 | 11,2 s, 8 uzlů | 0,0011 $ (≈ 0,02 Kč) |
gpt-4.1-mini | 6/6 | 6,4 s, 7 uzlů | 0,0025 $ |
gpt-4.1-nano | 6/6 | 2,8 s, 7 uzlů | 0,0005 $ |
gpt-5-mini | 6/6 | 24,5 s, 7 uzlů | 0,0120 $ |
o4-mini | 6/6 | 16,8 s, 7 uzlů | 0,0329 $ |
gpt-5-nano | 3/6 ❌ | 26,2 s, 7 uzlů | 0,0044 $ |
Doporučený výchozí je gpt-4o-mini. gpt-4.1-nano je levnější a rychlejší a prošel taky; gpt-4.1-mini je mezi nimi.
⚠️ Uvažujícím modelům se vyhněte (gpt-5-*, o4-*). Jsou 2–4× pomalejší a 5–30× dražší, protože platíte i za přemýšlení, které nikdy neuvidíte — o4-mini z 7 082 výstupních tokenů utratil 5 824 za uvažování. A gpt-5-nano rovnou ztratí tři funkce z šesti: spotřebuje celý limit na přemýšlení a nevrátí nic. Pokud uvažující model přesto chcete, KB_AI_REASONING_BUDGET a KB_AI_REASONING_EFFORT mu dají prostor (viz reference).
Výjimkou, kterou jsme změřili později (7. 11. 2026), je gpt-5.6-luna pro asistenta: zhruba 8 s na úkol ve 20 běžných úkolech, protože s voláním nástrojů běží s vypnutým přemýšlením (od v1.0.1 automaticky). Podrobnosti v návodu Vlastní klíč OpenAI.
Jiný model si nejrychleji ověříte tlačítkem Otestovat připojení a pak tím, že na titulní stránce necháte projekt navrhnout s AI (asistent se zeptá na pár otázek a postaví strom): buď se objeví mapa, nebo přijde chyba, která řekne proč.
Vlastní Ollama (ollama)
KB_AI_PROVIDER=ollama
KB_AI_URL=http://192.168.1.10:11434
KB_AI_MODEL=gpt-oss:20bkillBottleneck mluví s Ollamou přímo (/api/chat) — nic mezi tím není a ze sítě nic neodchází. Lokální model nic nestojí, hodinový strop na útratu se na něj nevztahuje.
Jaký model zvolit pro Ollamu
gpt-oss:20b je ověřený — na něm se killBottleneck testuje a odpovědi z něj dávají smysl i česky. Počítejte s tím, co potřebuje:
| Velikost modelu | ~14 GB |
| Rozumný běh | grafická karta s 16 GB paměti a víc |
| Doba odpovědi | jednotky až desítky sekund (naměřeno ~23 s pro návrh otázek) |
Jiný model si zkusit můžete a Ollama jich nabízí spoustu — na vaše riziko. Nejde o „chytrost“ modelu: killBottleneck po AI chce strojově čitelnou odpověď (JSON) a volání nástrojů (tool calling) pro asistenta; menší nebo uvažující modely ji občas vrátí useknutou — pak funkce tiše nic neudělá. Ze změřených: gemma3:12b (~8 GB) obstála a je použitelná na kartě s 12 GB, jen je pomalejší. Pro asistenta se osvědčily gemma4, qwen3 a gpt-oss.
Bez grafické karty model poběží z procesoru a odpovědi budou trvat minuty; k práci to nestačí.
Přepis řeči (hlasovky)
Hlasovky v asistentovi potřebují službu přepisu řeči. Mikrofon se v aplikaci ukáže jen tehdy, když nějaká je — mikrofon, který vždycky skončí chybou, je horší než žádný.
| Máte | Co nastavit |
|---|---|
openai u OpenAI | Nic — přepisuje tatáž služba (/audio/transcriptions, výchozí model whisper-1; gpt-4o-mini-transcribe je levnější a na našem vzorku stejně přesný, změníte ho přes KB_AI_TRANSCRIBE_MODEL nebo v poli Model přepisu řeči). |
openai u Groqu | Model se jmenuje jinak: KB_AI_TRANSCRIBE_MODEL=whisper-large-v3. |
openai u OpenRouteru, vLLM, LM Studia | Ty obvykle přepis nemají. Nastavte zvláštní přepisovač přes KB_TRANSCRIBE_* (speaches, whisper.cpp server, faster-whisper-server) — nebo zůstane mikrofon schovaný. |
ollama | Totéž: Ollama řeč nepřepisuje, přidejte KB_TRANSCRIBE_*. |
api | Přepis zajišťuje poskytovatel služby. |
Nahrávka jde jen přepisovací službě a nikam se neukládá; mikrofon funguje jen přes HTTPS (nebo na localhost). Podrobnosti k KB_TRANSCRIBE_VAD a dalším volbám jsou v referenci.
Strop na útratu
S vlastním API klíčem stojí každé volání AI peníze, takže jeden člověk smí ve výchozím stavu udělat nejvýš 60 AI operací za hodinu (KB_AI_MAX_PER_HOUR); v asistentovi se hlasovka počítá za 2, fotka za 3 a přiložené PDF za 2. Bez stropu by jediný účet — nebo zaseknutá karta v prohlížeči — dokázal kredit vypálit ve smyčce. Nad strop aplikace řekne Vyčerpali jste hodinový strop AI operací (60) a nic se neztratí. U asistenta platí strop u každého poskytovatele; u hůlky, souhrnu projektu a dalších drobných pomocníků jen pro openai — lokální Ollama nic nestojí a AI služba přes API má vlastní kvótu. (KB_AI_MAX_TRANSCRIBE_PER_HOUR, výchozí 20, je strop přímých volání přepisu přes API.)
Druhý strop je týdenní a organizační: sekce AI kredity ve Správě organizace ukazuje spotřebu v tazích (1 tah ≈ jedna běžná zpráva asistentovi) po lidech a týdnech a umí nastavit Tahů na týden s rezervou pro správce. Provozovatel ho může shora omezit přes KB_AI_KVOTA_TYDEN. Sekce se ukáže, jakmile je nastavený asistent.
Asistent na boku
Asistent — panel vpravo, kterému diktujete, posíláte fotky tabule a PDF a necháváte si připravit porady — je dnes hlavní cesta k AI. Co potřebuje:
- Model u
ollamaneboopenai, který umí volání nástrojů (tool calling):gpt-4o-mini,gemma4,qwen3,gpt-oss. Bere se zvláštní model asistenta (KB_CHAT_*), a když není, obecné nastavení AI. Když ani jedno nemíří naollamaneboopenai(obecná AI jeapi,customnebononeaKB_CHAT_PROVIDERje prázdný), tlačítko Asistent v hlavičce se neukáže. - Vlastní model jen pro asistenta (nepovinné):
KB_CHAT_PROVIDER/_URL/_MODEL/_TOKENpřebijí obecné nastavení — třeba levný model na hůlku a silnější na asistenta. U Ollamy nastavteKB_CHAT_NUM_CTX(jinak Ollama ořízne delší prompt na 4096 tokenů). - Obrázky (fotky poznámek, snímky obrazovky): zaškrtnout Asistent čte obrázky v AI funkcích (po uložení se model vyzkouší na vestavěném obrázku a obrázky se zapnou, jen když ho opravdu přečte), nebo
KB_VISION_*v.env— i jiný model než na text. - Hlasovky: přepis řeči podle tabulky výš.
- Dva modely naráz (
KB_CHAT_HYBRID): lehký na čtení a porady, hlavní na zápisy — pro ty, kdo šetří tokeny. Podrobně v referenci.
Správce AI a Správce struktury
Dvě role navíc, nezávislé na administrátorovi, se zapínají ve Správě organizace u člověka: Správce AI dostává přání „Chtěl bych tu automatizaci“ a vede registr AI agentů; Správce struktury kreslí organizační strukturu a jmenuje zástupce. Dokud nikoho neurčíte, dělá obojí administrátor.
Zvláštní model jen na ranní souhrny
Jednořádkové povzbuzení v Mém dni je krátký formátovaný text — bohatě stačí menší a rychlejší model. KB_SUMMARY_PROVIDER / _URL / _MODEL / _TOKEN přebijí obecné nastavení AI jen pro tuhle jednu úlohu. Když je necháte prázdné, použije se obecná konfigurace.
Souhrn se generuje ráno v KB_SUMMARY_HOUR (výchozí 6) jen účtům, které se přihlásily v posledních KB_SUMMARY_ACTIVE_DAYS dnech (výchozí 14, 0 = všem); ostatním se vygeneruje ve chvíli, kdy si aplikaci otevřou. AI nikdy nevypisuje seznamy vašich úkolů — ty se počítají z dat a jsou proklikávací. Vypnutí AI vás stojí přesně jednu větu v Mém dni.
Registrace a registrační klíč
První zaregistrovaný účet se stane administrátorem. Dál se lidé buď registrují sami, nebo je administrátor či manažer pozve ze Správy organizace (Pozvat uživatele).
Když nastavíte KB_SETUP_CODE, vyžaduje ho každá registrace (pole Registrační klíč organizace). Klíč rozdáte lidem, které chcete pustit dovnitř. Pozvánka od správce klíč nepotřebuje.
Dostupné z internetu?
KB_SETUP_CODE nastavte dřív, než instanci vystavíte ven. Prázdná hodnota znamená otevřenou registraci.
Přihlášení přes Google
Volitelné — uživatelé se pak přihlašují Googlem místo e-mailem a heslem.
- V Google Cloud Console: APIs & Services → Credentials → Create credentials → OAuth client ID → Web application.
- Do Authorized redirect URIs přidejte:
https://VASE-DOMENA/api/oauth2-redirect - Hodnoty vložte do
.env:bashKB_GOOGLE_CLIENT_ID=…apps.googleusercontent.com KB_GOOGLE_CLIENT_SECRET=… docker compose up -d --build— tlačítko Přihlásit se přes Google se objeví samo.
Prázdné proměnné = přihlášení přes Google je vypnuté a tlačítko se nezobrazuje. Tentýž OAuth klient plus KB_GOOGLE_PICKER_API_KEY zapne vybírání příloh přímo z Google Disku (ukládají se jako odkazy).
E-mail (SMTP)
SMTP se nastavuje v administraci PocketBase, ne v .env:
http://IP-SERVERU:8090/_/ → Settings → Mail settings
Účet superuživatele založíte odkazem z docker compose logs (viz Instalace).
Co se změní, když SMTP nenastavíte
E-maily jsou ve výchozím stavu vypnuté a instance je tak plně použitelná. Rozdíl je jen tady:
| Se SMTP | Bez SMTP | |
|---|---|---|
| Pozvánka nového člena | odejde e-mailem s odkazem | správci se ukáže dočasné heslo k předání |
| „Zapomněli jste heslo?“ | samoobslužné, odkaz přijde e-mailem | nenabízí se — heslo obnoví správce (viz níž) |
| Sdílení mapy na adresu bez účtu | odejde pozvánka k registraci (denní stropy KB_SHARE_INVITE_*) | dialog nabídne Kopírovat odkaz na registraci |
| Upozornění a denní souhrn | chodí podle předvoleb každého člověka | jen zvoneček v aplikaci |
Hlášení chyb a nápadů (KB_REPORT_TO) | položka v menu, hlášení chodí na vaši adresu | položka se vůbec nezobrazí |
Odkaz na obnovu hesla se bez SMTP schválně neukazuje: server by potvrdil odeslání, ale žádná zpráva by nedorazila a člověk by čekal na mail, který neexistuje. Notifikační e-maily jsou i se SMTP ve výchozím stavu vypnuté a řídí se předvolbami každého uživatele; KB_NOTIFY_EMAIL_DEFAULT=1 zachová staré chování „zapnuto, dokud si to člověk nevypne“.
Zapomenuté heslo bez SMTP
Členovi týmu heslo obnoví správce: Správa organizace → u člověka ikona klíče → potvrdit Obnovit heslo uživateli …?. Objeví se nové dočasné heslo k předání (Heslo je změněné. Nové předejte člověku osobně — už se nikde znovu nezobrazí.); dosavadní heslo hned přestane platit a dotyčný se odhlásí ze všech zařízení. Že mu heslo někdo změnil, se dozví ve zvonečku.
Správci samotnému takhle heslo nikdo neobnoví — nad ním nikdo není. Na vlastním serveru bez SMTP vede cesta přes administraci PocketBase, ke které máte jako provozovatel přístup:
http://IP-SERVERU:8090/_/→ přihlásit se superuživatelem- kolekce users → najít svůj účet → Change password
Nemáte superuživatele? Vytvořte ho na serveru (jméno služby je z docker-compose.yml):
docker compose exec killbottleneck /app/pocketbase superuser upsert vas@email.cz 'VaseSilneHeslo'Hostovaná verze (killbottleneck.cz)
Pošta tam funguje vždy, takže si správce vyžádá odkaz běžným „Zapomněli jste heslo?“ na přihlašovací stránce. Nic dalšího řešit netřeba.
Na co si dát pozor
Konzole na :8090/_/ jede po nešifrovaném HTTP — otevírejte ji jen z místní sítě nebo přes SSH tunel, ne přes internet. Heslo zadané na příkazové řádce navíc zůstane v historii shellu; po použití ho změňte v konzoli a řádek z historie smažte. Doporučení: založte si druhý účet s rolí administrátora a heslo k němu uložte do správce hesel.
Vzhled instance
Výchozí vzhled pro všechny (skin, logo, název organizace) se nenastavuje v .env, ale v aplikaci: Správa organizace → Výchozí vzhled instance a Organizace. Viz Skiny a Správa organizace.
Časové pásmo a opakující se šablony
TZ platí pro celou instanci, ne pro jednotlivé uživatele. Určuje, v jakém pásmu se počítá „každé pondělí“, „v pět ráno“ i připomínka „ve 14:00“. Tým rozprostřený přes pásma dostane pásmo serveru.
Pokud byl server v hodinu KB_AUTO_HOUR vypnutý, vytvoří se opakující se projekty v nejbližší pozdější hodinu téhož dne — nepřeskočí se potichu.
Limity příloh
KB_FILES_MB omezuje nahrané soubory za celou instanci:
- prázdné — bez limitu; výchozí stav pro self-hosting, je to váš disk
- číslo — strop v MB (
5000= 5 GB) 0— nahrávání vypnuté; přílohy jde pořád přidávat jako odkazy, které nezabírají místo a vždycky míří na aktuální verzi souboru
Proč je 0 výchozí u naší hostované verze
Není to úspora místa, ale záměr: cizí soubory u sebe neukládáme. Nedostanou se do našich záloh, nevzniká kolem nich „zpracováváme dokumenty zákazníka“ ve smlouvě a zůstávají tam, kde už jsou. U sebe na serveru je to samozřejmě váš disk a vaše rozhodnutí.
Automatizace
Týká se vás, jen když cíle poháníte automatizací. KB_PUBLIC_URL je adresa, na kterou se má agent ohlásit zpět — proč prázdná hodnota může vést k tomu, že vzdálený agent volá sám sebe, a proč je KB_ALLOW_PRIVATE_WEBHOOKS vypnuté, je v Proměnných prostředí → Automatizace.
Režim instance
KB_HOSTED nechte na vlastním serveru prázdné. Existuje pro instance běžící u poskytovatele vedle jiných zákazníků, kde správce instance nesmí zamířit AI službu do privátní sítě a oťukávat sousedy; vypíná i kontrolu nových verzí (aktualizace tam dělá provozovatel).
Souvisí
- Proměnné prostředí — úplná tabulka
- AI asistent — co s nastavenou AI dostanete
- Správa organizace — sekce AI funkce, AI kredity, lidé a role
- HTTPS a reverzní proxy — mikrofon a OAuth agentů jen přes HTTPS

