Быстрый старт
Требования
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| Node.js | 22.22+ | Последняя версия LTS |
| ОЗУ | 8 ГБ | 16 ГБ+ |
| Диск | 5 ГБ | 20 ГБ+ для моделей |
| GPU | Необязательно | 8 ГБ+ VRAM для быстрого локального инференса |
| Docker | Необязательно | Требуется для задач Work |
Libre WebUI работает с Ollama только на CPU, но для CPU лучше подходят небольшие модели. Для плагинов облачных поставщиков нужен лишь соответствующий ключ API.
Для чата, документов, артефактов и функций поставщиков Docker не требуется. Для Work он обязателен: Docker должен быть установлен на компьютере с бэкендом Libre WebUI, а процесс бэкенда должен иметь право его вызывать. Команда npx libre-webui не устанавливает Docker. Если Docker недоступен, остальная часть Libre WebUI продолжает работать, а Work сообщает Runtime unavailable; команды модели никогда не выполняются напрямую на хосте в качестве запасного варианта.
Запуск Libre WebUI
npx libre-webui@latest
Откройте http://localhost:8080. Создайте первую учётную запись — она станет администратором. Последующая публичная регистрация остаётся отключённой, если явно не задано ENABLE_SIGNUP=true.
Пакетный запуск хранит постоянные данные в ~/.libre-webui. Чтобы выбрать другое место, задайте абсолютный DATA_DIR; относительные значения разрешаются от каталога, в котором запускается npx.
Установка Ollama
Установите Ollama, затем загрузите небольшую универсальную модель:
ollama pull gemma4:12b
Другие удачные варианты: gemma4:26b (MoE), gemma4:31b (dense) и qwen3.8:27b. В Model Manager Libre WebUI можно просматривать установленные модели, искать в актуальной Ollama Library и загружать модели, не покидая приложение.
Для семантического поиска по документам также установите модель эмбеддингов:
ollama pull nomic-embed-text
Добавление облачных поставщиков
Облачные поставщики необязательны. Добавьте ключи отдельно для пользователя в Settings → API keys либо для всего сервера в backend/.env (после этого перезапустите бэкенд), затем включите поставщика в 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=...
Приложение обновляет списки моделей поставщиков, если это поддерживается. Не нужно держать документацию открытой, чтобы найти актуальные названия моделей.
Первая задача Work
Work предоставляет каждой задаче постоянный диалог и отдельную файловую систему на основе контейнера. Функция доступна прошедшим аутентификацию администраторам.
- Установите и запустите Docker на компьютере с бэкендом Libre WebUI.
- Создайте задачу кнопкой Work в заголовке боковой панели, через меню
+панели вкладок, на странице Home или сочетаниемCmd/Ctrl + Shift + U. - Выберите модель с поддержкой вызова инструментов.
- Опишите, что нужно создать или изменить, затем выберите Run.
- Следите за результатом во вкладках Files, Activity, Git, Terminal и Preview панели рабочей области.
Задача остаётся в боковой панели, поэтому к тому же диалогу и файлам можно вернуться позже. Остановка выполнения или предпросмотра сохраняет рабочую область. Удаление задачи безвозвратно удаляет её рабочую область.
Work может использовать установленную модель Ollama, модель Ollama Cloud либо настроенный плагин поставщика чата или completions. При выборе удалённого поставщика Libre WebUI заранее показывает уведомление: поставщик получит диалог, определения инструментов и все результаты инструментов, запрошенные моделью. Автономное выполнение может совершить несколько платных вызовов поставщика.
Границы среды выполнения, постоянства, сети, предпросмотра и безопасности описаны в Work: изолированные рабочие области.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Создайте первого администратора в браузере. Флаг регистрации и перезапуск не требуются; последующая публичная регистрация по умолчанию закрыта.
Если Ollama уже работает на хосте или другом компьютере:
docker compose -f docker-compose.external-ollama.yml up -d
Для ускорения на GPU NVIDIA используйте предоставленный репозиторием файл Compose для GPU.
Файлы Compose репозитория подключают сокет Docker хоста, поэтому Work доступен при установленном Docker. Это даёт приложению контроль над хостом, эквивалентный root, поэтому сначала прочитайте Work: изолированные рабочие области. В Linux задайте в .env переменную DOCKER_GID группы-владельца сокета. Удалите подключение, если Work не нужен.
Встроенная Ollama также доступна только внутри стека. Добавляйте -f docker-compose.ollama-host.yml лишь тогда, когда другому процессу хоста нужен её API; переопределение по умолчанию привязывается к loopback.
Навигация по приложению
На вкладке Home три раздела: Start (новый чат, чат incognito, новая задача Work), Continue (недавние диалоги и задачи) и Explore (Notes, Calendar, Automations, Models, Personas, Imagine). Те же разделы доступны в строке навигации боковой панели и палитре команд (Cmd/Ctrl + K), которая выполняет нечёткий поиск по чатам, задачам Work и действиям приложения, а также полнотекстовый поиск по сообщениям, заметкам и документам.
- Календарь — личный календарь с повторяющимися событиями.
- Автоматизации — запланированные выполнения AI, доставляемые как сеансы чата.
Сочетания клавиш
| Сочетание | Действие |
|---|---|
Cmd/Ctrl + K | Палитра команд (работает при вводе текста) |
Cmd/Ctrl + Shift + O | Новый чат |
Cmd/Ctrl + Shift + U | Новая задача Work |
Cmd/Ctrl + B | Переключение боковой панели |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Переключение темы |
? | Открытие Settings на вкладке Shortcuts |
Esc | Закрытие окна настроек |
Enter | Отправка сообщения |
Shift + Enter | Новая строка |