hubris

Agno

Подключение Hubris к Agno — быстрому фреймворку агентов на Python. Один ключ на агентов, инструменты и память.

Agno — фреймворк агентов на Python: инструменты, память, база знаний, команды агентов и готовый веб-интерфейс для отладки. Делает упор на скорость запуска агента и небольшой расход памяти.

Hubris подключается классом OpenAILike — отдельного пакета не нужно.

Требования

Подключение

import os

from agno.agent import Agent
from agno.models.openai.like import OpenAILike

agent = Agent(
    model=OpenAILike(
        id="anthropic/claude-sonnet-5",
        api_key=os.environ["HUBRIS_API_KEY"],
        base_url="https://api.hubris.pw/v1",
    ),
    markdown=True,
)

agent.print_response("Объясни, чем отличается кэш промпта от обычного ввода")

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

ID модели передаётся в id= полностью, вместе с вендором: anthropic/claude-sonnet-5, openai/gpt-5.6-luna. Никакого дополнительного префикса, в отличие от фреймворков поверх LiteLLM, здесь не нужно — OpenAILike ходит клиентом OpenAI напрямую.

Инструменты

import os

from agno.agent import Agent
from agno.models.openai.like import OpenAILike


def add(a: int, b: int) -> int:
    """Складывает два целых числа.

    Args:
        a: первое число
        b: второе число
    """
    return a + b


agent = Agent(
    model=OpenAILike(
        id="openai/gpt-5.6-luna",
        api_key=os.environ["HUBRIS_API_KEY"],
        base_url="https://api.hubris.pw/v1",
    ),
    tools=[add],
)

agent.print_response("Сколько будет 17 плюс 25? Используй инструмент.")

Агент сам вызовет функцию и вернёт результат. Для этого модель должна поддерживать вызов инструментов — смотрите tools в supported_parameters карточки модели в каталоге.

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

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

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

Встроенный провайдер «Hubris»

Мы отправили в Agno отдельный класс модели — pull request на ревью. После приёма подключение будет через from agno.models.hubris import Hubris, с ключом из переменной HUBRIS_API_KEY. Пока PR не принят, работает описанный выше способ через OpenAILike — это то же самое подключение.

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

Ошибка авторизации

Ключ неверный или отозван. Он начинается на sk-gw-, без пробелов по краям; целиком виден только при создании. Новый — в разделе «Ключи».

Ошибка про модель

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

Агент не вызывает инструменты

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

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

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

Проверено на Agno 3.0.8, 9 сентября 2026.

Что дальше

Обновлено: