Перейти до основного вмісту

Швидкий старт

Вимоги​

КомпонентМінімумРекомендовано
Node.js22.22+Найновіша версія LTS
Оперативна пам’ять8 ГБ16 ГБ+
Диск5 ГБ20 ГБ+ для моделей
GPUНеобов’язково8 ГБ+ VRAM для швидкого локального виведення
DockerНеобов’язковоПотрібен для завдань Work

Libre WebUI працює з Ollama лише на CPU, але для процесора краще підходять менші моделі. Для плагінів хмарних постачальників потрібен тільки відповідний ключ API.

Чат, документи, артефакти й функції постачальників не потребують Docker. Work потребує: Docker має бути встановлений на комп’ютері, де працює серверна частина Libre WebUI, а її процес повинен мати право викликати Docker. Команда 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 надає кожному завданню постійний діалог і окрему файлову систему на основі контейнера. Функція доступна автентифікованим адміністраторам.

  1. Установіть і запустіть Docker на комп’ютері із серверною частиною Libre WebUI.
  2. Створіть завдання кнопкою Work у заголовку бічної панелі, через меню + панелі вкладок, на сторінці Home або сполученням Cmd/Ctrl + Shift + U.
  3. Виберіть модель, яка підтримує виклики інструментів.
  4. Опишіть, що потрібно створити або змінити, і натисніть Run.
  5. Стежте за результатом на вкладках Files, Activity, Git, Terminal і Preview панелі робочого простору.

Завдання залишається на бічній панелі, тому до того самого діалогу й файлів можна повернутися пізніше. Зупинка виконання або попереднього перегляду зберігає робочий простір. Видалення завдання безповоротно видаляє його робочий простір.

Work може використовувати встановлену модель Ollama, модель Ollama Cloud або налаштований плагін постачальника чату чи доповнень. Після вибору віддаленого постачальника 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Новий рядок

Наступні кроки​