AnythingLLM
Подключение Hubris к AnythingLLM — рабочему месту с базой знаний и агентами. Один ключ на чат, эмбеддинги и агентские вызовы.
AnythingLLM — рабочее место поверх своих документов: загружаете файлы и ссылки, они превращаются в базу знаний, и модель отвечает по ней. Есть рабочие пространства с раздельными правами, агенты с инструментами и веб-поиском. Ставится десктоп-приложением или контейнером на сервер.
Hubris подключается как провайдер Generic OpenAI — и для чата, и для агентов. Один ключ, оплата в рублях с общего баланса.
Требования
Подключение чата
- Откройте Settings → AI Providers → LLM.
- В списке провайдеров выберите Generic OpenAI.
- Заполните поля:
| Поле | Значение |
|---|---|
| Base URL | https://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 — для длинных ответов мало) |
- Сохраните. Модель начнёт отвечать в чатах рабочего пространства.
Адрес — именно api.hubris.pw, с api. в начале и /v1 в конце. Домен hubris.pw — это сайт и личный кабинет: запросы к API он не обслуживает, и подключение по нему выглядит как «сервис не отвечает».
Model context window и Max Tokens заполняйте по карточке модели в каталоге, а не наугад. Если поставить окно больше настоящего, AnythingLLM отправит слишком длинный контекст и получит ошибку; если сильно меньше — начнёт молча выбрасывать куски документов из ответа.
Эмбеддинги для базы знаний
Чтобы документы искались, нужен эмбеддер. В Settings → AI Providers → Embedder выберите Generic OpenAI и укажите тот же адрес и ключ, а моделью — эмбеддер из каталога:
| Поле | Значение |
|---|---|
| Base URL | https://api.hubris.pw/v1 |
| Embedding Model | openai/text-embedding-3-small |
| Max embedding chunk length | 8192 — длина фрагмента текста в символах, можно оставить как есть |
| 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 ₽, через СБП, банковской картой или по счёту для юридических лиц.
Что дальше
- Каталог моделей — ID и окна контекста для полей настроек.
- Эмбеддинги — что уходит в Hubris при индексации документов.
- Управление ключами — отдельный ключ под установку, чтобы расход был виден отдельно.
- Расходы — детализация по запросам и моделям.
Обновлено:
Vercel AI SDK
Подключение Hubris к Vercel AI SDK — библиотеке для LLM-приложений на TypeScript. Текст, инструменты, структурированный вывод и стриминг в React.
Chatbox
Подключение Hubris к Chatbox — десктоп-клиенту для чата с моделями. Весь каталог в одном приложении на Windows, macOS, Linux, Android и iOS.