Open WebUI

Open WebUI — это удобный интерфейс чата для моделей, доступ к которым предоставляется через API. С его помощью можно общаться с AI-агентами в привычном формате диалога.

Разберемся, как установить Open WebUI и подключить к нему AI-агента.

Предполагается, что у вас уже создан AI-агент. Если нет, поможет наша документация, где подробно описано, что такое агент и как его создать.

Установка

Интерфейс можно развернуть как локально на рабочем компьютере, так и на удаленном сервере, если нужен постоянный доступ к чату. В нашем примере мы развернем систему локально. На сервере установка выполняется аналогично, разве что, возможно, вам захочется настроить реверс-прокси для удобного доступа по домену и подключить SSL-сертификат.

Для корректной работы Open WebUI потребуется минимум 2 ГБ ОЗУ.

Убедитесь, что у вас установлены docker и docker compose:

docker --version
docker compose version 

Создайте файл docker-compose.yaml с содержимым:

services:
  openwebui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
volumes:
  open-webui:

Сохраните манифест и запустите контейнер:

docker compose up

Docker скачает образ и развернет Open WebUI. После появления логотипа в терминале откройте в браузере страницу http://localhost:3000/.

Если загрузилась приветственная страница — установка прошла успешно.

Вернитесь в терминал и остановите контейнер сочетанием Ctrl+C, а затем запустите его в фоновом режиме:

docker compose up -d

В браузере обновите страницу http://localhost:3000/, вы также должны наблюдать приветственную страницу.

Подключение агента

Нажмите на кнопку «Давайте начнем».

Заполните данные для создания аккаунта администратора. Локально можно не заморачиваться с паролем, а если установка выполняется на сервере — укажите стойкий вариант. Почта, введенная при регистрации, используется только как идентификатор и как логин для входа, никакие письма на нее не приходят.

После создания аккаунта вы окажетесь в главном рабочем пространстве. Но чтобы подключить агентов, нужно сделать еще пару шагов.

Нажмите на имя аккаунта в левом нижнем углу и выберите «Панель администратора».

Дальше откройте вкладку «Настройки» → пункт «Подключения» и включите переключатель напротив «Прямые подключения». Сохраните изменения.

Теперь перейдем к подключению модели. Вновь нажмите на имя пользователя, но теперь выберите пункт «Настройки».

Перейдите в раздел «Подключения» и нажмите на иконку плюсика.

В открывшемся меню укажите:

• URL — значение из поля «OpenAI URL» во вкладке «Доступ» на странице агента в панели Timeweb Cloud;

• Ключ — API-токен для доступа к агенту

После этого нажмите на кнопку проверки соединения.  Если ошибок нет — сохраните.

Закройте окно с настройками и нажмите на кнопку «Новый чат». В меню выбора модели у вас отобразится модель вашего AI-агента. Если этого не произошло — обновите страницу браузера и проверьте вновь.

На этом установка и настройка Open WebUI завершена.