Open WebUI — это удобный интерфейс чата для моделей, доступ к которым предоставляется через API. С его помощью можно общаться с AI-агентами в привычном формате диалога.
Разберемся, как установить Open WebUI и подключить к нему AI-агента.
Предполагается, что у вас уже создан AI-агент. Если нет, поможет наша документация, где подробно описано, что такое агент и как его создать.
Установка
Интерфейс можно развернуть как локально на рабочем компьютере, так и на удаленном сервере, если нужен постоянный доступ к чату.
Для корректной работы Open WebUI потребуется минимум 2 ГБ ОЗУ.
Убедитесь, что у вас установлены docker и docker compose:
Если вы разворачиваете Open WebUI локально, достаточно создать файл docker-compose.yaml с содержимым:
Если вы хотите развернуть интерфейс на сервере, для удобства доступа стоит использовать домен и SSL-сертификат. Для этого создайте файл .env:
В DOMAIN укажите домен, на котором будет работать интерфейс. Для домена должна быть настроена A-запись на ваш сервер.
LETSENCRYPT_EMAIL — почтовый ящик, который будет использоваться для получения сертификата.
TZ — таймзона.
Создайте файл docker-compose.yaml со следующим содержимым:
Сохраните манифест и запустите контейнер:
Docker скачает образ и развернет Open WebUI. После появления логотипа в терминале откройте в браузере страницу http://localhost:3000/ или используйте ваш домен, если интерфейс разворачивается на сервере (в дальнейшем в инструкции будем использовать localhost).
Если загрузилась приветственная страница — установка прошла успешно.
Вернитесь в терминал и остановите контейнер сочетанием Ctrl+C, а затем запустите его в фоновом режиме:
В браузере обновите страницу http://localhost:3000/, вы также должны наблюдать приветственную страницу.
Подключение агента
Нажмите на кнопку «Давайте начнем».
Заполните данные для создания аккаунта администратора. Локально можно не заморачиваться с паролем, а если установка выполняется на сервере — укажите стойкий вариант. Почта, введенная при регистрации, используется только как идентификатор и как логин для входа, никакие письма на нее не приходят.
Open WebUI поддерживает два способа подключения агентов:
- Через прямое подключение — для каждого пользователя указывается собственный API-ключ и URL;
- Для всех пользователей — настройки подключения задаются один раз в панели администратора и используются по умолчанию.
Рассмотрим оба варианта.
После создания аккаунта вы окажетесь в главном рабочем пространстве. Но чтобы подключить агентов, нужно сделать еще пару шагов.
Нажмите на имя аккаунта в левом нижнем углу и выберите «Панель администратора».
Дальше откройте вкладку «Настройки» → пункт «Подключения» и включите переключатель напротив «Прямые подключения». Сохраните изменения.
Теперь перейдем к подключению модели. Вновь нажмите на имя пользователя, но теперь выберите пункт «Настройки».
Перейдите в раздел «Подключения» и нажмите на иконку плюсика.
В открывшемся меню укажите:
-
URL — значение из поля «OpenAI URL» во вкладке «Доступ» на странице агента в панели Timeweb Cloud;
После этого нажмите на кнопку проверки соединения. Если ошибок нет — сохраните.
Закройте окно с настройками и нажмите на кнопку «Новый чат». В меню выбора модели у вас отобразится модель вашего AI-агента. Если этого не произошло — обновите страницу браузера и проверьте вновь.
На этом установка и настройка Open WebUI завершена.