hubris

Langflow

Подключение Hubris к Langflow — визуальному конструктору потоков и агентов. Модели каталога доступны в компонентах Language Model, Embedding Model и Agent.

Langflow — визуальный конструктор потоков для языковых моделей: блоки соединяются мышью на холсте, готовый поток публикуется как HTTP-эндпоинт или MCP-сервер. Подходит и для прототипа за вечер, и для рабочего сервиса.

Hubris подключается как OpenAI-совместимый провайдер. Langflow сам читает наш каталог и предлагает найденные модели в разделах Language Models и Embedding Models — дальше они выбираются в любом компоненте Language Model, Embedding Model или Agent.

Требования

  • Langflow — своя установка (uv pip install langflow) или облако
  • Аккаунт на hubris.pw и API-ключ

Подключение

  1. Нажмите на аватар профиля → SettingsModel Providers.
  2. Выберите провайдера OpenAI Compatible — он ставится вместе с Langflow, ничего доустанавливать не нужно.
  3. Заполните поля:
ПолеПеременная окруженияЗначение
Base URLOPENAI_COMPATIBLE_BASE_URLhttps://api.hubris.pw/v1
API KeyOPENAI_COMPATIBLE_API_KEYваш ключ, начинается на sk-gw-
  1. Нажмите Save. Langflow проверит связь по /v1/models и покажет найденные модели.
  2. Включите нужные — они появятся в выпадающих списках компонентов. По умолчанию включены только первые несколько моделей каталога, остальные нужно отметить самому.

Список моделей у нас без разбивки по назначению, поэтому Langflow показывает все модели и в Language Models, и в Embedding Models. В компоненте Embedding Model выбирайте именно эмбеддер (например openai/text-embedding-3-small) — чат-модель на этом месте вернёт ошибку.

Адрес — именно api.hubris.pw, с api. в начале и /v1 в конце. Домен hubris.pw — это сайт и личный кабинет: запросы к API он не обслуживает, и подключение по нему выглядит как «сервис не отвечает».

Через компонент OpenAI

Если провайдер настраивать не хочется, тот же результат даёт обычный компонент OpenAI на холсте: в OpenAI API Key вставьте свой ключ, в поле OpenAI API Base (оно в дополнительных настройках компонента, откройте их через ползунок Controls) укажите https://api.hubris.pw/v1, а в Model Name впишите ID из нашего каталога — список принимает произвольное значение. Разница в том, что настройка живёт внутри одного потока, а не глобально.

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

ID берите из каталога — они пишутся полностью, вместе с вендором и без даты в конце: anthropic/claude-sonnet-5, а не claude-sonnet-5.

IDКогда подходит
google/gemini-3.7-flashдешёвые шаги потока, классификация, маршрутизация
anthropic/claude-sonnet-5основной узел рассуждения, работа с длинным контекстом
deepseek/deepseek-v4-proнедорогое рассуждение и код
openai/text-embedding-3-smallэмбеддинги для векторного поиска

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

Встроенный бандл «Hubris»

Мы отправили в Langflow отдельный бандл с собственной карточкой, живым списком моделей и подсказками по длине контекста — pull request на ревью. После приёма он будет ставиться как uv pip install "lfx-bundles[hubris]", а ключ задаваться переменной HUBRIS_API_KEY. Пока он не принят, работает описанный выше способ через OpenAI Compatible — подключение то же самое, отличается только название провайдера в списке.

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

Langflow не сохраняет Base URL

По умолчанию у Langflow включена защита от SSRF, и локальные адреса (localhost, 127.0.0.1) он блокирует. Наш адрес публичный, под запрет не попадает. Если Langflow всё же отказывается сохранять адрес — проверьте, не подставился ли в поле локальный хост из прежней настройки.

Список моделей пустой

  • Проверьте адрес и ключ: https://api.hubris.pw/v1, ключ начинается на sk-gw- и без пробелов по краям.
  • Откройте api.hubris.pw/v1/models в браузере. Открывается — значит, API доступен, и дело в ключе или адресе.
  • Langflow пишет причину прямо под полем при сохранении: «Authentication failed … Check OPENAI_COMPATIBLE_API_KEY» — неверный ключ; «returned HTTP 421» — адрес без api. в начале.

Поток падает с ошибкой про модель

Текст вида Error building Component Language Model: … 404 … model_not_found означает, что ID не совпал с каталожным. Он должен совпадать символ в символ, вместе с вендором перед косой чертой. Короткие имена без вендора и имена с датой на конце мы не принимаем — подстановки «похожей» модели не происходит.

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

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

Проверено на Langflow 1.12.0, 9 сентября 2026.

Что дальше

Обновлено: