Rychlý start
Požadavky
| Požadavek | Minimum | Doporučeno |
|---|---|---|
| Node.js | 22.22+ | Nejnovější LTS |
| RAM | 8 GB | 16 GB+ |
| Disk | 5 GB | 20 GB+ pro modely |
| GPU | Volitelná | 8 GB+ VRAM pro rychlou místní inferenci |
| Docker | Volitelný | Vyžadován pro úlohy Work |
Libre WebUI funguje s Ollama jen na CPU, ale pro CPU jsou vhodnější menší modely. U cloudových pluginů potřebujete pouze příslušný API klíč.
Chat, dokumenty, artifacts a funkce poskytovatelů Docker nevyžadují. Work ano: Docker musí být nainstalován na stroji s backendem Libre WebUI a backend jej musí smět volat. npx libre-webui Docker neinstaluje. Bez Dockeru zbytek Libre WebUI funguje dál, zatímco Work hlásí Runtime unavailable; příkazy modelu se nikdy jako náhradní řešení nespouštějí přímo na hostiteli.
Spuštění Libre WebUI
npx libre-webui@latest
Otevřete http://localhost:8080. Vytvořte první účet; ten se stane administrátorem. Další veřejná registrace zůstane vypnutá, dokud explicitně nenastavíte ENABLE_SIGNUP=true.
Zabalený spouštěč uchovává trvalý stav v ~/.libre-webui. Jinou cestu zvolte absolutní hodnotou DATA_DIR; relativní hodnoty se vyhodnocují z adresáře, kde spouštíte npx.
Instalace Ollama
Nainstalujte Ollama a stáhněte malý obecný model:
ollama pull gemma4:12b
Dalšími silnými volbami jsou gemma4:26b (MoE), gemma4:31b (dense) a qwen3.8:27b. Model Manager v Libre WebUI zobrazuje nainstalované modely, vyhledává v živé knihovně Ollama a stahuje modely přímo v aplikaci.
Pro sémantické vyhledávání v dokumentech nainstalujte také embedding model:
ollama pull nomic-embed-text
Přidání cloudových poskytovatelů
Cloudoví poskytovatelé jsou volitelní. Klíče přidejte pro jednotlivé uživatele v Settings → API keys nebo pro celý server v backend/.env (poté restartujte backend) a poskytovatele zapněte v Settings:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Aplikace podporované seznamy modelů obnovuje sama. Dokumentaci nemusíte nechávat otevřenou kvůli aktuálním názvům modelů.
První úloha Work
Work dává každé úloze trvalou konverzaci a oddělený souborový systém v kontejneru. Je dostupný přihlášeným administrátorům.
- Nainstalujte a spusťte Docker na stroji s backendem Libre WebUI.
- Spusťte úlohu tlačítkem Work v záhlaví postranního panelu, z nabídky
+na liště karet, z Home nebo pomocíCmd/Ctrl + Shift + U. - Zvolte model s podporou volání nástrojů.
- Popište, co chcete vytvořit nebo změnit, a vyberte Run.
- Sledujte výsledek na kartách Files, Activity, Git, Terminal a Preview.
Úloha zůstává v postranním panelu, takže se můžete vrátit ke stejné konverzaci a souborům. Zastavení běhu nebo náhledu pracovní prostor zachová. Smazání úlohy jej odstraní natrvalo.
Work může použít nainstalovaný model Ollama, model Ollama Cloud nebo nakonfigurovaný chat/completion plugin. Při volbě vzdáleného poskytovatele Libre WebUI před během upozorní, že poskytovatel obdrží konverzaci, definice nástrojů a vyžádané výsledky nástrojů. Autonomní běh může provést více zpoplatněných volání.
Podrobnosti o runtime, trvalosti, síti, náhledech a bezpečnosti najdete v Work: izolované pracovní prostory.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
V prohlížeči vytvořte prvního administrátora. Není třeba příznak registrace ani restart; další veřejná registrace je ve výchozím stavu zavřená.
Pokud Ollama již běží na hostiteli nebo jiném stroji:
docker compose -f docker-compose.external-ollama.yml up -d
Pro akceleraci NVIDIA GPU použijte GPU Compose soubor z repository.
Compose soubory připojují Docker socket hostitele, aby byl Work dostupný. Aplikace tím získává kontrolu nad hostitelem ekvivalentní rootu, proto nejprve přečtěte Work: izolované pracovní prostory. V Linuxu nastavte v .env hodnotu DOCKER_GID skupiny socketu. Pokud Work nechcete, připojení odstraňte.
Vestavěná Ollama je dostupná pouze interně. Přidejte -f docker-compose.ollama-host.yml jen tehdy, když její API potřebuje jiný proces hostitele; override se ve výchozím stavu váže na loopback.
Orientace v aplikaci
Karta Home má části Start (nový chat, inkognito chat, nová úloha Work), Continue (nedávné konverzace a úlohy) a Explore (Notes, Calendar, Automations, Models, Personas, Imagine). Stejné cíle jsou v postranním panelu a paletě příkazů (Cmd/Ctrl + K), která fuzzy vyhledává chaty, úlohy Work a akce a fulltextově prohledává zprávy, poznámky a dokumenty.
- Kalendář — kalendář pro uživatele s opakovanými událostmi.
- Automatizace — plánované běhy AI doručené jako chatové relace.
Klávesové zkratky
| Zkratka | Akce |
|---|---|
Cmd/Ctrl + K | Paleta příkazů (funguje i při psaní) |
Cmd/Ctrl + Shift + O | Nový chat |
Cmd/Ctrl + Shift + U | Nová úloha Work |
Cmd/Ctrl + B | Přepnout postranní panel |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Přepnout motiv |
? | Otevřít Settings na kartě Shortcuts |
Esc | Zavřít dialog nastavení |
Enter | Odeslat zprávu |
Shift + Enter | Nový řádek |