Skip to content

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:

bash
docker compose up -d --build

AI ​

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í OllamaVáš 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 APIVzdálená AI služba kompatibilní s killBottleneck API — adresa a token od vašeho poskytovatele. Bez vlastního GPU a údržby.
custom — Vlastní endpointVáš vlastní mezikus dodržující stejný kontrakt — kontrakt je sepsaný tady. Asistent na boku ani čtení obrázků s ním nejedou.
Totéž co v .env, ale s tlačítkem Otestovat připojení — řekne hned, jestli klíč platí a model existuje.

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á.

bash
KB_AI_PROVIDER=openai
KB_AI_URL=https://openrouter.ai/api/v1
KB_AI_TOKEN=sk-...
KB_AI_MODEL=openai/gpt-4o-mini
SlužbaKB_AI_URLPříklad KB_AI_MODEL
OpenAIhttps://api.openai.com/v1gpt-4o-mini
OpenRouterhttps://openrouter.ai/api/v1openai/gpt-4o-mini
Groqhttps://api.groq.com/openai/v1(název od poskytovatele)
vLLM / LM Studio / llama.cpphttp://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.)

ModelProšloMapa z cíleCena za šest funkcí
gpt-4o-mini ⭐6/611,2 s, 8 uzlů0,0011 $ (≈ 0,02 Kč)
gpt-4.1-mini6/66,4 s, 7 uzlů0,0025 $
gpt-4.1-nano6/62,8 s, 7 uzlů0,0005 $
gpt-5-mini6/624,5 s, 7 uzlů0,0120 $
o4-mini6/616,8 s, 7 uzlů0,0329 $
gpt-5-nano3/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) ​

bash
KB_AI_PROVIDER=ollama
KB_AI_URL=http://192.168.1.10:11434
KB_AI_MODEL=gpt-oss:20b

killBottleneck 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ěhgrafická karta s 16 GB paměti a víc
Doba odpovědijednotky 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áteCo nastavit
openai u OpenAINic — 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 GroquModel se jmenuje jinak: KB_AI_TRANSCRIBE_MODEL=whisper-large-v3.
openai u OpenRouteru, vLLM, LM StudiaTy 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ý.
ollamaTotéž: Ollama řeč nepřepisuje, přidejte KB_TRANSCRIBE_*.
apiPř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.

AI kredity: kvóta 60 tahů na týden s rezervou správců 30 % — správci mohou čerpat až 60, ostatní členové sdílí nejvýš 42.

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:

  1. Model u ollama nebo openai, 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íří na ollama nebo openai (obecná AI je api, custom nebo none a KB_CHAT_PROVIDER je prázdný), tlačítko Asistent v hlavičce se neukáže.
  2. Vlastní model jen pro asistenta (nepovinné): KB_CHAT_PROVIDER / _URL / _MODEL / _TOKEN přebijí obecné nastavení — třeba levný model na hůlku a silnější na asistenta. U Ollamy nastavte KB_CHAT_NUM_CTX (jinak Ollama ořízne delší prompt na 4096 tokenů).
  3. 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.
  4. Hlasovky: přepis řeči podle tabulky výš.
  5. 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.

  1. V Google Cloud Console: APIs & Services → Credentials → Create credentials → OAuth client ID → Web application.
  2. Do Authorized redirect URIs přidejte: https://VASE-DOMENA/api/oauth2-redirect
  3. Hodnoty vložte do .env:
    bash
    KB_GOOGLE_CLIENT_ID=…apps.googleusercontent.com
    KB_GOOGLE_CLIENT_SECRET=…
  4. 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 SMTPBez SMTP
Pozvánka nového členaodejde e-mailem s odkazemsprávci se ukáže dočasné heslo k předání
„Zapomněli jste heslo?“samoobslužné, odkaz přijde e-mailemnenabízí se — heslo obnoví správce (viz níž)
Sdílení mapy na adresu bez účtuodejde pozvánka k registraci (denní stropy KB_SHARE_INVITE_*)dialog nabídne Kopírovat odkaz na registraci
Upozornění a denní souhrnchodí podle předvoleb každého člověkajen zvoneček v aplikaci
Hlášení chyb a nápadů (KB_REPORT_TO)položka v menu, hlášení chodí na vaši adresupolož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:

  1. http://IP-SERVERU:8090/_/ → přihlásit se superuživatelem
  2. 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):

bash
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í ​

Open source pod licencí MIT · © Tengo s.r.o.