Szybki start
Wymagania
| Wymaganie | Minimum | Zalecane |
|---|---|---|
| Node.js | 22.22+ | Najnowsza wersja LTS |
| RAM | 8 GB | 16 GB+ |
| Dysk | 5 GB | 20 GB+ na modele |
| GPU | Opcjonalne | 8 GB+ VRAM do szybkiego lokalnego wnioskowania |
| Docker | Opcjonalny | Wymagany do zadań Work |
Libre WebUI działa z Ollama wyłącznie na procesorze, ale do pracy na CPU lepiej nadają się mniejsze modele. W przypadku wtyczek dostawców chmurowych potrzebujesz tylko odpowiedniego klucza API.
Chat, dokumenty, artefakty i funkcje obsługiwane przez dostawców nie wymagają Dockera. Work go wymaga: Docker musi być zainstalowany na komputerze, na którym działa backend Libre WebUI, a proces backendu musi mieć możliwość jego wywoływania. Polecenie npx libre-webui nie instaluje Dockera. Jeśli Docker jest niedostępny, pozostała część Libre WebUI nadal działa, a Work zgłasza Runtime unavailable; polecenia modelu nigdy nie są awaryjnie wykonywane bezpośrednio na hoście.
Uruchamianie Libre WebUI
npx libre-webui@latest
Otwórz http://localhost:8080. Utwórz pierwsze konto; zostanie ono kontem administratora. Późniejsza rejestracja publiczna pozostaje wyłączona, chyba że jawnie ustawisz ENABLE_SIGNUP=true.
Dołączony program uruchamiający przechowuje trwałe dane w ~/.libre-webui. Ustaw bezwzględną ścieżkę DATA_DIR, aby wybrać inną lokalizację; wartości względne są rozwiązywane względem katalogu, w którym uruchamiasz npx.
Instalowanie Ollama
Zainstaluj Ollama, a następnie pobierz mały model ogólnego przeznaczenia:
ollama pull gemma4:12b
Inne dobre opcje to gemma4:26b (MoE), gemma4:31b (dense) i qwen3.8:27b. W Model Manager w Libre WebUI możesz przeglądać zainstalowane modele, przeszukiwać aktualną bibliotekę Ollama Library i pobierać modele bez opuszczania aplikacji.
Do semantycznego wyszukiwania w dokumentach zainstaluj również model embeddingowy:
ollama pull nomic-embed-text
Dodawanie dostawców chmurowych
Dostawcy chmurowi są opcjonalni. Dodaj klucze osobno dla każdego użytkownika w Settings → API keys albo dla całego serwera w backend/.env (następnie uruchom ponownie backend), po czym włącz dostawcę w 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=...
Jeśli dostawca to obsługuje, aplikacja odświeża jego listę modeli. Nie musisz trzymać otwartej dokumentacji, aby znaleźć najnowsze nazwy modeli.
Pierwsze zadanie Work
Work zapewnia każdemu zadaniu trwałą rozmowę i oddzielny system plików oparty na kontenerze. Funkcja jest dostępna dla uwierzytelnionych administratorów.
- Zainstaluj i uruchom Docker na komputerze z backendem Libre WebUI.
- Uruchom zadanie przyciskiem Work w nagłówku paska bocznego, z menu
+na pasku kart, ze strony Home albo skrótemCmd/Ctrl + Shift + U. - Wybierz model obsługujący wywołania narzędzi.
- Opisz, co chcesz zbudować lub zmienić, a następnie wybierz Run.
- Obserwuj wynik na kartach Files, Activity, Git, Terminal i Preview w panelu obszaru roboczego.
Zadanie pozostaje na pasku bocznym, więc możesz później wrócić do tej samej rozmowy i plików. Zatrzymanie wykonania lub podglądu zachowuje obszar roboczy. Usunięcie zadania trwale usuwa jego obszar roboczy.
Work może używać zainstalowanego modelu Ollama, modelu Ollama Cloud albo skonfigurowanej wtyczki dostawcy czatu lub uzupełnień. Po wybraniu zdalnego dostawcy Libre WebUI wyświetla przed uruchomieniem informację: dostawca otrzyma rozmowę, definicje narzędzi i wszystkie wyniki narzędzi zażądane przez model. Autonomiczne wykonanie może wykonać wiele płatnych wywołań dostawcy.
Szczegóły środowiska wykonawczego, trwałości, sieci, podglądu i bezpieczeństwa znajdziesz w Work: izolowane obszary robocze.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Utwórz pierwszego administratora w przeglądarce. Flaga rejestracji ani ponowne uruchomienie nie są potrzebne; kolejne publiczne rejestracje są domyślnie zamknięte.
Jeśli Ollama działa już na hoście lub innym komputerze:
docker compose -f docker-compose.external-ollama.yml up -d
Do akceleracji na GPU NVIDIA użyj pliku Compose GPU dostarczonego w repozytorium.
Pliki Compose repozytorium montują gniazdo Dockera hosta, dzięki czemu Work jest dostępny po zainstalowaniu Dockera. Daje to aplikacji kontrolę nad hostem równoważną uprawnieniom roota, dlatego najpierw przeczytaj Work: izolowane obszary robocze. W systemie Linux ustaw w .env zmienną DOCKER_GID na grupę będącą właścicielem gniazda. Usuń montowanie, jeśli nie chcesz używać Work.
Dołączona Ollama jest również dostępna wyłącznie wewnętrznie. Dodaj -f docker-compose.ollama-host.yml tylko wtedy, gdy inny proces hosta potrzebuje jej API; nadpisanie domyślnie wiąże usługę z interfejsem loopback.
Orientacja w aplikacji
Karta Home ma trzy sekcje: Start (nowy czat, czat incognito, nowe zadanie Work), Continue (ostatnie rozmowy i zadania) oraz Explore (Notes, Calendar, Automations, Models, Personas, Imagine). Te same miejsca znajdziesz w wierszu nawigacji paska bocznego i w palecie poleceń (Cmd/Ctrl + K), która tolerancyjnie przeszukuje czaty, zadania Work i działania aplikacji oraz pełną treść wiadomości, notatek i dokumentów.
- Kalendarz — kalendarz każdego użytkownika z wydarzeniami cyklicznymi.
- Automatyzacje — zaplanowane wykonania AI dostarczane jako sesje czatu.
Skróty klawiaturowe
| Skrót | Działanie |
|---|---|
Cmd/Ctrl + K | Paleta poleceń (działa podczas pisania) |
Cmd/Ctrl + Shift + O | Nowy czat |
Cmd/Ctrl + Shift + U | Nowe zadanie Work |
Cmd/Ctrl + B | Przełączenie paska bocznego |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Przełączenie motywu |
? | Otwarcie Settings na karcie Shortcuts |
Esc | Zamknięcie okna ustawień |
Enter | Wysłanie wiadomości |
Shift + Enter | Nowy wiersz |