Интеграция · LibreChat

LibreChat в России: свой ChatGPT на 400+ моделях

LibreChat повторяет интерфейс ChatGPT, но разворачивается на вашем сервере. Polza.ai подключается одним блоком в librechat.yaml — и в списке появляются Claude, GPT, DeepSeek и ещё 400+ моделей с оплатой картой РФ.

  • Интерфейс как у ChatGPT
  • Настройка в одном YAML
  • Работает из РФ напрямую
  • Карта РФ и СБП
librechat.yaml

endpoints:

custom:

- name: 'Polza'

apiKey: '${POLZA_API_KEY}'

baseURL: 'https://polza.ai/api/v1'

models:

default: ['anthropic/claude-sonnet-5.5', 'openai/gpt-6.1-sol']

fetch: false

Так выглядит подключение: ключ, адрес API и модель.

Что такое LibreChat

LibreChat — интерфейс с открытым кодом, который почти полностью повторяет ChatGPT: история диалогов, ветки, правка сообщений, загрузка файлов. Только работает он на вашем сервере.

Главное отличие от оригинала — выбор модели. Провайдеры описываются в конфигурационном файле librechat.yaml, и любой OpenAI-совместимый API подключается как custom endpoint.

LibreChat ставят, когда команде нужен знакомый интерфейс без подписки на каждого сотрудника, а администратору — настройка, которую можно хранить в репозитории.

Почему LibreChat не отвечает из России

Сам LibreChat ставится через Docker без ограничений. Проблема — в провайдерах, ключи которых он просит при первом входе.

Встроенные провайдеры недоступны

Готовые разделы OpenAI, Anthropic и Google ведут на зарубежные API, которые не обслуживают российские адреса.

Свой endpoint на Polza отвечает из РФ.

Ключи не купить

Для каждого встроенного провайдера нужен свой аккаунт и зарубежная карта.

Карта РФ, СБП или счёт для юрлица.

Пять провайдеров — пять ключей

Чтобы дать команде Claude, GPT и Gemini, приходится заводить и пополнять отдельные аккаунты.

Один ключ, 400+ моделей.

Расход команды не виден

Когда у каждого вендора свой аккаунт, общий расход команды приходится собирать из нескольких кабинетов.

Статистика по ключам и моделям в кабинете.

Локальным моделям не хватает сил

Ollama закрывает простые задачи, но для анализа и кода нужны флагманы.

Облачные модели рядом с Ollama.

Юрлицу не провести оплату

Оплату зарубежному API не примет бухгалтерия.

Договор, счёт, УПД и НДС.

Как подключить LibreChat к Polza

Установка через Docker, подключение — блоком в librechat.yaml. Нужны Git и Docker Desktop.

Что нужно для запуска

Git и Docker Desktop

Docker Desktop должен быть запущен перед docker compose up. Первый запуск скачивает образы и занимает несколько минут.

Ключ Polza

Создаётся в кабинете за минуту. Хранится в .env, в YAML — только ссылка на переменную.

Редактор для YAML

Подойдёт любой. Отступы в librechat.yaml важны: ошибка в них не даст серверу стартовать.

  1. Шаг 1

    Установите LibreChat

    Склонируйте репозиторий и скопируйте файлы-примеры — значений по умолчанию хватает для локального запуска. На Windows вместо cp используйте copy.

    Терминал · установка
    $ git clone https://github.com/LibreChat-AI/LibreChat.git
    $ cd LibreChat
    $ cp .env.example .env
    $ cp librechat.example.yaml librechat.yaml
    $ cp docker-compose.override.yml.example docker-compose.override.yml
  2. Шаг 2

    Положите ключ в .env

    Ключ лучше не писать в YAML, а сослаться на переменную. Добавьте строку в конец .env:

    .env
    POLZA_API_KEY=pza_••••••••••••
  3. Шаг 3

    Опишите endpoint в librechat.yaml

    В секцию endpoints → custom добавьте блок Polza. При fetch: false в списке будут только модели из default — так в него не попадут модели для картинок и озвучки из каталога.

    librechat.yaml
    endpoints:
      custom:
        - name: 'Polza'
          apiKey: '${POLZA_API_KEY}'
          baseURL: 'https://polza.ai/api/v1'
          models:
            default:
              - 'anthropic/claude-sonnet-5.5'
              - 'openai/gpt-6.1-sol'
              - 'deepseek/deepseek-v4.1-flash'
            fetch: false
          titleConvo: true
          titleModel: 'deepseek/deepseek-v4.1-flash'
          modelDisplayLabel: 'Polza'
  4. Шаг 4

    Подключите файл и запустите

    В docker-compose.override.yml раскомментируйте монтирование ./librechat.yaml в /app/librechat.yaml для сервиса api. Затем запустите контейнеры и откройте http://localhost:3080.

    Терминал · запуск
    $ docker compose up -d
    # после правок librechat.yaml
    $ docker compose down && docker compose up -d

Ключ на каждого пользователя

Если сервер общий, а платить каждый хочет сам, вместо ссылки на переменную укажите apiKey: 'user_provided'. Тогда LibreChat попросит у каждого пользователя его собственный ключ Polza, и расходы разойдутся по личным кабинетам. Для команды с общим бюджетом удобнее один ключ в .env и статистика в кабинете Polza.

Открыть каталог моделей

Что умеет LibreChat

Интерфейс, привычный по ChatGPT, но с выбором модели и данными на вашем сервере.

Знакомый интерфейс

Боковая панель с историей, ветки диалогов, правка сообщений — переучиваться не нужно.

Несколько провайдеров

Polza, Ollama и другие endpoints описываются в одном файле и выбираются в переключателе модели.

Конфигурация в файле

Вся настройка — в librechat.yaml: её легко хранить в репозитории и переносить между серверами.

Ключи пользователей

Режим user_provided позволяет каждому работать на своём ключе.

Названия чатов

Заголовки диалогов генерирует отдельная модель — можно поставить дешёвую.

Открытый код

Проект распространяется с открытым кодом, данные остаются на вашем сервере.

Облачные модели через Polza

Один блок в endpoints.custom. Видеокарта не нужна, хватит небольшого сервера.

Ollama плюс Polza

Второй блок с name: 'Ollama' и адресом http://host.docker.internal:11434/v1/. Обе группы моделей выбираются в одном интерфейсе.

Чем LibreChat отличается от Open WebUI и AnythingLLM

Все три подключаются к Polza — различаются способом настройки и тем, для чего их ставят.

LibreChat

Интерфейс как у ChatGPT, настройка в YAML. Хорош, когда провайдеров несколько и конфигурацию нужно держать под контролем.

Настройка мышкой в панели администратора и самый простой старт с Ollama. Под него есть отдельная страница.

Рабочие пространства и база знаний из документов, есть десктоп-версия без Docker. Под него тоже есть страница.

Напрямую или через Polza

LibreChat: Напрямую или через Polza
Из РоссииВстроенные провайдерыLibreChat через Polza
ОплатаЗарубежная карта, в валютеКарта РФ, СБП, счёт для юрлиц
Доступ к APIЗакрыт, нужны обходные путиРаботает из РФ напрямую
Выбор моделейСвой ключ на каждого вендораClaude, GPT, Gemini, DeepSeek и ещё 400
НастройкаРаздел и ключ под каждогоОдин блок в librechat.yaml
Модель оплатыПредоплата в валютеЗа токены, лимиты не сгорают
ДокументыНетДоговор, счёт, УПД, НДС
РасходыВ кабинете каждого вендораСтатистика по ключам и моделям

Сколько стоит LibreChat

LibreChat бесплатный и с открытым кодом. В Polza.ai команда платит только за токены облачных моделей — по ценам каталога и в рублях, без подписки на каждого.

Чат для всей команды

DeepSeek V4.1 Flash и Gemini 3.8 Flash — быстрые ответы в разы дешевле флагманов.

Сложные задачи

Claude Sonnet 5.5 и GPT-6.1 Sol — анализ, тексты и код.

Заголовки чатов

Для titleModel хватит дешёвой быстрой модели — заголовки генерируются на каждый новый диалог.

Модели, с которых стоит начать

Актуальные цены за 1M токенов — в каталоге моделей.

Если Polza не появилась в списке

Пять причин, на которые приходится почти вся переписка с поддержкой.

Endpoint Polza не виден в интерфейсе

librechat.yaml не смонтирован в контейнер. Проверьте блок volumes в docker-compose.override.yml и перезапустите docker compose down и up -d.

Сервер падает при старте

Ошибка в YAML — чаще всего отступы или кавычки. Команда docker compose logs api покажет, какое поле не прошло проверку.

Ответ 401

Переменная POLZA_API_KEY не попала в окружение или ключ вставлен с пробелом. Проверьте строку в .env и перезапустите контейнеры.

Модель не найдена

ID в models.default должен совпадать с каталогом Polza полностью, вместе с префиксом вендора: anthropic/claude-sonnet-5.5.

Ollama из Docker не отвечает

Внутри контейнера localhost — это сам контейнер. Укажите http://host.docker.internal:11434/v1/, а Ollama на хосте настройте через OLLAMA_HOST, чтобы она принимала подключения не только с 127.0.0.1.

Для команд и юрлиц

Счёт, УПД и НДС

Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.

Ключ на сотрудника

Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.

Контроль бюджета

Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.

Помощь с переездом

Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.

Вопросы и ответы

Что такое LibreChat?

Бесплатный интерфейс с открытым кодом, повторяющий ChatGPT. Разворачивается на своём сервере и подключается к разным провайдерам моделей, включая любые OpenAI-совместимые API.

Как установить LibreChat?

Через Docker: git clone, копия .env из .env.example и docker compose up -d. Интерфейс откроется на http://localhost:3080.

Куда вписывать Polza?

В librechat.yaml, секция endpoints.custom: name, apiKey, baseURL https://polza.ai/api/v1 и список моделей Polza.ai в models.default.

Почему изменения в librechat.yaml не применились?

В Docker файл нужно смонтировать через docker-compose.override.yml, а после правок перезапустить контейнеры: docker compose down и docker compose up -d.

Можно ли подтянуть весь каталог моделей?

Да, fetch: true загрузит список с /models. Но в каталоге Polza.ai есть и модели для картинок, видео и озвучки, поэтому для чата удобнее явный список.

Как подключить Ollama рядом с Polza?

Вторым блоком в endpoints.custom с name: Ollama и baseURL http://host.docker.internal:11434/v1/. Ключ Ollama не проверяет, но поле apiKey обязательно — подойдёт любое значение.

Сервер не стартует после правки YAML

Скорее всего, ошибка валидации конфига. Посмотрите docker compose logs api — там будет указано поле с ошибкой.

Другие интеграции

Тот же ключ работает в остальных инструментах: меняется только место, куда вписать Base URL.

Редакторы и агенты в коде

Ставятся в редактор или запускаются в терминале. Читают проект, правят файлы, гоняют тесты.

Десктоп-клиенты

Обычные приложения с окном чата: поставили, вписали ключ и работаете.

Свой чат для команды

Веб-интерфейс на своём сервере: общий доступ для коллег, история, документы. Рядом с локальными моделями работают облачные через тот же ключ.

Автоматизация и фреймворки

Сценарии, боты и собственные сервисы — там, где модель вызывается из кода или из ноды.

Все интеграции

Что почитать

Кто проверял эту инструкцию

Евгений Лебедев

Руководитель техподдержки · редакция Polza.AI

Собрал и проверил подключение LibreChat на актуальной версии: прошёл все шаги заново, сверил идентификаторы моделей с каталогом и перепроверил адреса API. Если инструмент обновится и инструкция разойдётся с реальностью — правим страницу.

Обновлено · Как работает редакция · Нашли неточность? Напишите нам

Подключите LibreChat за десять минут

Один блок в librechat.yaml — и команда работает в привычном интерфейсе на любых моделях каталога, из России и за рубли.

Остались вопросы? Быстрый старт, поддержка в Telegram или support@polza.ai

Инструкцию проверила редакция Polza.AI, обновлено . Цены и список моделей меняются — актуальные смотрите в каталоге.

Сайт использует cookie.