LibreChat

LibreChat — self-hosted чат для команды: несколько пользователей со своими историями, агенты и инструменты, загрузка файлов, поиск по переписке, вход через корпоративный SSO. Ставится контейнером на свой сервер или запускается из исходников.

Hubris подключается как своя точка в блоке custom файла librechat.yaml. LibreChat сам запрашивает каталог, и модели появляются в меню выбора модели — отдельным пунктом рядом с остальными провайдерами.

Требования

• Развёрнутый LibreChat с доступом к librechat.yaml и переменным окружения
• Аккаунт на hubris.pw и API-ключ

Подключение

Добавьте ключ в .env рядом с остальными:

HUBRIS_API_KEY=sk-gw-ваш-ключ

И точку подключения в librechat.yaml:

version: 1.3.16

endpoints:
  custom:
    - name: 'Hubris'
      apiKey: '${HUBRIS_API_KEY}'
      baseURL: 'https://api.hubris.pw/v1'
      models:
        default:
          - 'anthropic/claude-sonnet-5'
          - 'openai/gpt-5.6-luna'
          - 'google/gemini-3.7-flash'
          - 'deepseek/deepseek-v4-pro'
        fetch: true
      titleConvo: true
      titleModel: 'openai/gpt-4o-mini'
      modelDisplayLabel: 'Hubris'

Строка version обязательна. Если librechat.yaml у вас уже есть, оставьте в нём свою и добавьте только блок endpoints. Если заводите файл с нуля, возьмите номер из librechat.example.yaml вашей версии LibreChat: без него сервер при старте пишет Invalid custom config file с ошибкой Required по полю version и останавливается.

Перезапустите LibreChat — контейнер или npm run backend, если он запущен из исходников. Затем откройте меню выбора модели над чатом: это кнопка с названием текущего выбора, в новом чате — My Agents. В меню появится пункт Hubris. Наведите на него — откроется список моделей с полем Поиск Hubris моделей…. Выберите модель и задайте вопрос: ответ подпишется как Hubris.

fetch: true и список моделей

Наш /v1/models отвечает в формате OpenAI, поэтому fetch: true работает: LibreChat подтянет весь каталог, больше 500 моделей, и покажет их в меню Hubris. Искать удобнее по части имени — например, gpt-4o-mini.

Если каталог не ответил вовремя (LibreChat ждёт его 5 секунд), в меню останутся только модели из models.default — поэтому этот список нужен и при fetch: true.

Список из пятисот пунктов неудобен, поэтому у большинства установок разумнее поставить fetch: false и перечислить нужное руками в models.default — тогда в меню будет ровно то, что вы выбрали. Значения в примере выше — начальный набор, замените на свой.

ID берите из каталога: они пишутся полностью, вместе с вендором, в точности как в каталоге.

Заголовки диалогов

titleConvo: true включает автоматические названия чатов, а titleModel задаёт модель для них. Это отдельный служебный запрос на каждый новый диалог, поэтому ставьте туда недорогую модель без размышления — например openai/gpt-4o-mini: заголовок обходится в несколько токенов. Модели, которые размышляют перед ответом, тратят на то же название в десятки раз больше: google/gemini-3.7-flash на пробе потратил на заголовок 271 токен вместо трёх.

Если не указать titleModel, LibreChat возьмёт ту же модель, в которой идёт разговор, и заголовок «Список покупок» напишет флагман.

Выбор моделей

Каталог у нас открыт без ключа — список можно посмотреть прямо в браузере: api.hubris.pw/v1/models.

Решение проблем

LibreChat не запускается после правки librechat.yaml

Если в логе Invalid custom config file и Exiting due to invalid configuration, посмотрите, на какое поле указывает ошибка. Чаще всего в новом файле нет строки version — см. «Подключение».

Пункта Hubris нет в меню выбора модели

• Проверьте, что LibreChat видит нужный librechat.yaml (в контейнере — что файл смонтирован) и что после правки его перезапустили: файл читается при старте, правка на лету не подхватывается.
• Проверьте отступы: custom — список, каждая точка начинается с - name:.
• Убедитесь, что HUBRIS_API_KEY объявлен в .env, который читает LibreChat, — подстановка ${HUBRIS_API_KEY} берёт значение оттуда.

В меню только модели из models.default

При fetch: true это значит, что каталог не загрузился: в логе LibreChat будет Failed to fetch models from Hubris API.

• Проверьте адрес: https://api.hubris.pw/v1 — с api. в начале, с /v1 в конце.
• Откройте api.hubris.pw/v1/models в браузере. Открывается — значит, API доступен, и дело в ключе, адресе или сети сервера.
• Если сервер LibreChat не ходит наружу напрямую или сеть медленная, перечислите модели в models.default и поставьте fetch: false.

Модель есть в каталоге, но чат отвечает ошибкой про модель

ID должен совпадать с каталожным символ в символ, вместе с вендором перед косой чертой. Короткие имена без вендора и имена с датой на конце мы не принимаем.

Ошибка про недостаточный баланс

Пополните баланс в кабинете — от 500 ₽, через СБП, банковской картой или по счёту для юридических лиц.

Что дальше

• Каталог моделей — ID для models.default.
• Управление ключами — отдельный ключ под установку, чтобы расход был виден отдельно.
• Расходы — детализация по запросам и моделям.
• Chat Completions — что именно уходит в Hubris из LibreChat.

Обновлено: 16 сентября 2026 г.