Repolode
Предложить
bubbuild

bubbuild/republic

Библиотека Python, которая предоставляет единый интерфейс для чата, потоковой передачи, вызова инструментов и структурированного вывода у разных AI-провайдеров.

Открыть на GitHubСайт
Звёзды
84
Форки
23
Открытые issues
0
Последний коммит
5 дней назад

Что это?

Republic — библиотека Python, которая объединяет несколько провайдеров AI-моделей под единым интерфейсом. Модель выбирается строкой `provider:model`, поэтому для перехода между такими сервисами, как OpenAI, Anthropic, Google или DeepSeek, достаточно изменить это имя. Каждый провайдер получает API-ключ из переменной окружения `REPUBLIC_<PROVIDER>_API_KEY`.

Библиотека поддерживает завершение чата, потоковую передачу ответов в виде типизированных событий, вызовы инструментов и структурированный вывод. Она отвечает только за слой провайдеров: циклы агентов, выполнение инструментов и шлюзы остаются на стороне приложения. Необязательное асинхронное middleware может отслеживать события каждого вызова и изменять их — например, добавлять повторы.

В документации также описаны работа с медиафайлами, эмбеддинги, генерация изображений, модели принятия решений, история диалогов и пользовательские провайдеры. Требуется Python 3.11 или новее.

Ключевые возможности

  • 01Переключение между провайдерами заменой строки `provider:model`.
  • 02Потоковая передача ответов в виде типизированных событий.
  • 03Вызовы инструментов и структурированный вывод через единый API.
  • 04Необязательное асинхронное middleware для отслеживания вызовов, изменения их поведения и добавления повторов.
  • 05Поддержка эмбеддингов, генерации изображений и пользовательских провайдеров.

Сценарии использования

  • Разработка приложения, которое должно работать с несколькими LLM-провайдерами.
  • Добавление потокового чата или вызова инструментов в сервис на Python без привязки к одному поставщику.
  • Создание собственного цикла агента поверх клиента, не зависящего от провайдера.

Быстрый старт

  1. 1

    Установите Republic с помощью pip

    python -m pip install republic
  2. 2

    Задайте ключ API OpenAI в переменных окружения

    export REPUBLIC_OPENAI_API_KEY="your-api-key"
  3. 3

    Запустите пример на Python, который вызывает модель в режимах чата и потоковой передачи

Что важно знать

  • Требуется Python 3.11 или более поздняя версия.
  • Для каждого провайдера нужен отдельный ключ API или вход в аккаунт.

В подборках

Инструменты для стриминга

Темы

#llm#python#sdk#api-client#streaming#tool-calling#structured-output#developer-tools

Частые вопросы

Что такое republic?
Библиотека Python, которая предоставляет единый интерфейс для чата, потоковой передачи, вызова инструментов и структурированного вывода у разных AI-провайдеров. Republic — библиотека Python, которая объединяет несколько провайдеров AI-моделей под единым интерфейсом. Модель выбирается строкой `provider:model`, поэтому для перехода между такими сервисами, как OpenAI, Anthropic, Google или DeepSeek, достаточно изменить это имя. Каждый провайдер получает API-ключ из переменной окружения `REPUBLIC_<PROVIDER>_API_KEY`.
republic можно использовать бесплатно? Какая у него лицензия?
republic распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
republic всё ещё поддерживается?
Активно поддерживается. Последний коммит в republic — 2 нояб. 2026 г..
Для чего можно использовать republic?
Разработка приложения, которое должно работать с несколькими LLM-провайдерами. Добавление потокового чата или вызова инструментов в сервис на Python без привязки к одному поставщику. Создание собственного цикла агента поверх клиента, не зависящего от провайдера.
Как установить republic?
Установите Republic с помощью pip: python -m pip install republic Задайте ключ API OpenAI в переменных окружения: export REPUBLIC_OPENAI_API_KEY="your-api-key" Запустите пример на Python, который вызывает модель в режимах чата и потоковой передачи
Где скачать republic?
Исходный код и инструкции по установке — на GitHub: https://github.com/bubbuild/republic

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты