hubris

AnythingLLM

Подключение Hubris к AnythingLLM — рабочему месту с базой знаний и агентами. Один ключ на чат, эмбеддинги и агентские вызовы.

AnythingLLM — рабочее место поверх своих документов: загружаете файлы и ссылки, они превращаются в базу знаний, и модель отвечает по ней. Есть рабочие пространства с раздельными правами, агенты с инструментами и веб-поиском. Ставится десктоп-приложением или контейнером на сервер.

Hubris подключается как провайдер Generic OpenAI — и для чата, и для агентов. Один ключ, оплата в рублях с общего баланса.

Требования

  • AnythingLLM — десктоп-версия или своя установка
  • Аккаунт на hubris.pw и API-ключ

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

  1. Откройте SettingsAI ProvidersLLM.
  2. В списке провайдеров выберите Generic OpenAI.
  3. Заполните поля:
ПолеЗначение
Base URLhttps://api.hubris.pw/v1
API Keyваш ключ из личного кабинета, начинается на sk-gw-
Selected Modelкак только введены Base URL и ключ, AnythingLLM сам запросит наш каталог и покажет выпадающий список «Your loaded models» — выберите модель, например anthropic/claude-sonnet-5. Если список не загрузился, поле станет текстовым — впишите ID из каталога руками
Model context windowокно модели в токенах, например 1000000 для Claude Sonnet 5
Max Tokensверхний предел ответа, например 8192 (по умолчанию стоит 1024 — для длинных ответов мало)
  1. Сохраните. Модель начнёт отвечать в чатах рабочего пространства.

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

Model context window и Max Tokens заполняйте по карточке модели в каталоге, а не наугад. Если поставить окно больше настоящего, AnythingLLM отправит слишком длинный контекст и получит ошибку; если сильно меньше — начнёт молча выбрасывать куски документов из ответа.

Эмбеддинги для базы знаний

Чтобы документы искались, нужен эмбеддер. В SettingsAI ProvidersEmbedder выберите Generic OpenAI и укажите тот же адрес и ключ, а моделью — эмбеддер из каталога:

ПолеЗначение
Base URLhttps://api.hubris.pw/v1
Embedding Modelopenai/text-embedding-3-small
Max embedding chunk length8192 — длина фрагмента текста в символах, можно оставить как есть
API Keyтот же ключ (поле подписано «optional», но нам ключ нужен)

Эмбеддинги считаются один раз при загрузке документа и стоят копейки по сравнению с чатом — но при переиндексации большой библиотеки расход будет заметен разово.

Агенты

Агентские вызовы в AnythingLLM (@agent в чате) идут через тот же провайдер Generic OpenAI с теми же адресом и ключом: инструменты передаются модели штатным способом OpenAI (tools), поэтому модель должна поддерживать вызов инструментов. Берите модель, у которой в карточке каталога есть tools — например anthropic/claude-sonnet-5, openai/gpt-5.6-luna или google/gemini-3.8-flash.

Модель без поддержки инструментов в агентском режиме будет отвечать текстом вместо действий.

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

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

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

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

Почему через Generic OpenAI, а не отдельным провайдером

Мы отправляли в AnythingLLM отдельного провайдера — со своей карточкой, знаком и живым списком моделей. Заявку закрыли, и это правильное решение: в их правилах прямо записано, что сервисы со стандартной схемой OpenAI (/v1/chat/completions, /v1/models, обычный Bearer-ключ) отдельной интеграции не получают и подключаются именно через Generic OpenAI. Мы ровно такой сервис.

То есть описанный выше способ — не временный обход в ожидании чего-то лучшего, а тот путь, который в AnythingLLM предусмотрен. Ничего ждать не нужно.

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

Ошибка подключения при сохранении настроек

  • Проверьте адрес: https://api.hubris.pw/v1 — с api. в начале, с /v1 в конце, без косой черты после.
  • Проверьте ключ: он начинается на sk-gw-, без пробелов по краям.
  • Откройте api.hubris.pw/v1/models в браузере. Открывается — значит, API доступен, и дело в ключе или адресе.

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

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

Документы загрузились, но ответы их не учитывают

Проверьте, что эмбеддер настроен и документы прикреплены к рабочему пространству, а не просто лежат в общем хранилище: в AnythingLLM это два разных шага.

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

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

Что дальше

Обновлено: