hubris

Pydantic AI

Подключение Hubris к Pydantic AI — агентному фреймворку от авторов Pydantic с типизированными инструментами и структурированным выводом.

Pydantic AI — агентный фреймворк от команды Pydantic: типизированные инструменты, структурированный вывод через модели Pydantic, встроенная валидация ответов. Hubris подключается как OpenAI-совместимый провайдер: любая модель каталога работает через OpenAIChatModel.

Требования

Установка

pip install -U "pydantic-ai-slim[openai]"
export HUBRIS_API_KEY="sk-gw-ваш-ключ"

Подключение

import os

from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai import OpenAIProvider

model = OpenAIChatModel(
    "anthropic/claude-sonnet-5",
    provider=OpenAIProvider(
        base_url="https://api.hubris.pw/v1",
        api_key=os.environ["HUBRIS_API_KEY"],
    ),
)
agent = Agent(model)
result = agent.run_sync("Какая столица у Франции?")
print(result.output)

ID модели — из каталога, целиком, с вендором перед косой чертой.

Инструменты и структурированный вывод

Работают штатно, потому что Hubris передаёт tools и response_format в формате OpenAI:

from pydantic import BaseModel


class City(BaseModel):
    name: str
    country: str


agent = Agent(model, output_type=City)


@agent.tool_plain
def population(city: str) -> int:
    """Население города."""
    return 12_600_000 if city == "Москва" else 0


result = agent.run_sync("Самый большой город России?")
print(result.output)

Какие параметры поддерживает конкретная модель, видно в поле supported_parameters ответа GET /v1/models.

Рекомендуемые модели

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

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

401 Unauthorized

Ключ не передан или отозван. Проверьте переменную HUBRIS_API_KEY; полный ключ виден только при создании в разделе «Ключи».

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

ID должен совпадать с каталогом символ в символ. Короткие имена без вендора Hubris не принимает.

Проверено на Pydantic AI 2.41.0, 9 сентября 2026.

Что дальше

Обновлено: