Repolode
andrewyng

andrewyng/aisuite

Лёгкая библиотека Python с единым API в стиле OpenAI для разных LLM-провайдеров и Agents API с поддержкой инструментов и MCP.

Звёзды
16,353
Форки
1,734
Открытые issues
161
Последний коммит
в прошлом месяце

Что это?

aisuite — библиотека Python для обращения к большим языковым моделям от разных провайдеров через единый интерфейс. Модели задаются в формате <provider>:<model-name>, поэтому для переключения между OpenAI, Anthropic, Google, Ollama и другими поддерживаемыми провайдерами достаточно изменить одну строку. Запросы и ответы имеют общую структуру, а основные параметры, такие как temperature и max_tokens, работают одинаково у разных провайдеров.

Помимо чата, aisuite позволяет превращать обычные функции Python в инструменты: библиотека генерирует схемы, выполняет вызовы и передаёт результаты обратно модели в цикле, ограниченном параметром max_turns. Для более длительных задач предусмотрен Agents API с Runner, готовыми наборами инструментов для работы с файлами, git и shell, политиками подтверждения вызовов инструментов, хранилищами состояния для возобновления запусков и встроенной поддержкой серверов Model Context Protocol (MCP).

В проект также входят потоковая передача данных (в синхронном и асинхронном режимах) и документация о том, как добавлять новых провайдеров с помощью простого класса-адаптера.

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

  • 01Единый API для chat completions у разных LLM-провайдеров с переключением через строку модели.
  • 02Потоковая передача результатов для синхронных и асинхронных вызовов, включая фрагменты вызовов инструментов.
  • 03Функции Python можно передавать как инструменты; схемы генерируются автоматически, а вызовы выполняются в цикле с несколькими ходами.
  • 04Agents API с Runner, готовыми наборами инструментов для файлов, git и shell, а также политиками подтверждения вызовов инструментов.
  • 05Встроенная поддержка MCP: модели можно передавать инструменты любого MCP-сервера.
  • 06Расширяемые адаптеры провайдеров, соответствующие простой схеме именования.

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

  • Сравнение провайдеров OpenAI, Anthropic и других или переключение на запасной вариант без переписывания кода приложения.
  • Создание Python-ассистента, который вызывает локальные функции или инструменты MCP-серверов.
  • Создание прототипа многоэтапного агента для работы с файлами и историей git в репозитории кода.
  • Запуск одних и тех же запросов на локальных моделях Ollama и в размещённых API.

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

  1. 1

    Установите базовый пакет aisuite из PyPI

    pip install aisuite
  2. 2

    Установите SDK провайдера, которого планируете использовать (например, Anthropic)

    pip install 'aisuite[anthropic]'
  3. 3

    Настройте API-ключи провайдеров, следуя краткому руководству по Chat Completions

  4. 4

    Создайте клиент и вызовите модель, используя формат provider:model

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

  • Для вызова моделей нужны API-ключи их провайдеров, поэтому перед первым использованием потребуется выполнить настройку.
  • Для некоторых функций, например Agents API и MCP tools, нужны дополнительные установки либо в README они описаны как отдельные концепции.
  • OpenWorker — настольное приложение на базе aisuite — перенесён в собственный репозиторий.

Темы

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

Что такое aisuite?
Лёгкая библиотека Python с единым API в стиле OpenAI для разных LLM-провайдеров и Agents API с поддержкой инструментов и MCP. aisuite — библиотека Python для обращения к большим языковым моделям от разных провайдеров через единый интерфейс. Модели задаются в формате <provider>:<model-name>, поэтому для переключения между OpenAI, Anthropic, Google, Ollama и другими поддерживаемыми провайдерами достаточно изменить одну строку. Запросы и ответы имеют общую структуру, а основные параметры, такие как temperature и max_tokens, работают одинаково у разных провайдеров.
aisuite можно использовать бесплатно? Какая у него лицензия?
aisuite распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
aisuite всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в aisuite — 18 сент. 2026 г..
Для чего можно использовать aisuite?
Сравнение провайдеров OpenAI, Anthropic и других или переключение на запасной вариант без переписывания кода приложения. Создание Python-ассистента, который вызывает локальные функции или инструменты MCP-серверов. Создание прототипа многоэтапного агента для работы с файлами и историей git в репозитории кода. Запуск одних и тех же запросов на локальных моделях Ollama и в размещённых API.
Как установить aisuite?
Установите базовый пакет aisuite из PyPI: pip install aisuite Установите SDK провайдера, которого планируете использовать (например, Anthropic): pip install 'aisuite[anthropic]' Настройте API-ключи провайдеров, следуя краткому руководству по Chat Completions Создайте клиент и вызовите модель, используя формат provider:model
Где скачать aisuite?
Исходный код и инструкции по установке — на GitHub: https://github.com/andrewyng/aisuite

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

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