Repolode
andrewyng

andrewyng/aisuite

Biblioteca Python leve que oferece uma API no estilo OpenAI para vários provedores de LLM, além de uma Agents API com ferramentas e suporte a MCP.

Estrelas
16,353
Forks
1,734
Issues abertas
161
Último commit
mês passado

O que é?

aisuite é uma biblioteca Python para chamar modelos de linguagem de vários provedores por meio de uma única interface. Os modelos são identificados como <provider>:<model-name>; assim, para alternar entre OpenAI, Anthropic, Google, Ollama e outros provedores compatíveis, basta mudar uma string. As requisições e respostas seguem a mesma estrutura, e parâmetros básicos como temperature e max_tokens funcionam da mesma forma em todos os provedores.

Além da camada de chat, o aisuite pode transformar funções Python comuns em ferramentas: ele gera os schemas, executa as chamadas e devolve os resultados ao modelo em um loop controlado por max_turns. Para tarefas mais longas, há uma Agents API com um Runner, toolkits prontos para arquivos, git e shell, políticas de aprovação de ferramentas, armazenamentos de estado para retomar execuções e suporte nativo a servidores do Model Context Protocol (MCP).

O projeto também inclui streaming síncrono e assíncrono e documenta como adicionar novos provedores usando uma classe adapter simples.

Recursos principais

  • 01API unificada de chat completions para vários provedores de LLM, com troca feita por uma string de modelo.
  • 02Streaming de saída em chamadas síncronas e assíncronas, incluindo fragmentos de chamadas de ferramentas.
  • 03Funções Python podem ser passadas como ferramentas, com geração automática de schemas e um loop com várias etapas.
  • 04Agents API com um Runner, toolkits prontos para files/git/shell e políticas de aprovação de ferramentas.
  • 05Suporte nativo a MCP para disponibilizar ao modelo as ferramentas de qualquer servidor MCP.
  • 06Adapters extensíveis para provedores, seguindo uma convenção simples de nomenclatura.

Casos de uso

  • Comparar provedores ou alternar entre OpenAI, Anthropic e outros sem reescrever o código da aplicação.
  • Criar um assistente Python que usa ferramentas e chama funções locais ou servidores MCP.
  • Prototipar um agente com várias etapas que trabalha com os arquivos e o histórico git de um repositório de código.
  • Executar os mesmos prompts em modelos locais do Ollama e em APIs hospedadas.

Início rápido

  1. 1

    Instale o pacote base aisuite do PyPI

    pip install aisuite
  2. 2

    Instale o SDK do provedor que você pretende usar (por exemplo, Anthropic)

    pip install 'aisuite[anthropic]'
  3. 3

    Configure as chaves de API dos seus provedores seguindo o guia de início rápido do Chat Completions

  4. 4

    Crie um cliente e chame um modelo usando o formato provider:model

Antes de usar

  • Você precisa das chaves de API dos provedores dos modelos que chamar, então é necessário fazer algumas configurações antes do primeiro uso.
  • Alguns recursos, como Agents API e MCP tools, exigem instalações adicionais ou são descritos como conceitos separados no README.
  • OpenWorker, o aplicativo para desktop baseado no aisuite, foi transferido para seu próprio repositório.

Tópicos

Perguntas frequentes

O que é aisuite?
Biblioteca Python leve que oferece uma API no estilo OpenAI para vários provedores de LLM, além de uma Agents API com ferramentas e suporte a MCP. aisuite é uma biblioteca Python para chamar modelos de linguagem de vários provedores por meio de uma única interface. Os modelos são identificados como <provider>:<model-name>; assim, para alternar entre OpenAI, Anthropic, Google, Ollama e outros provedores compatíveis, basta mudar uma string. As requisições e respostas seguem a mesma estrutura, e parâmetros básicos como temperature e max_tokens funcionam da mesma forma em todos os provedores.
aisuite é gratuito? Qual é a licença?
aisuite é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
aisuite ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de aisuite foi em 18 de set. de 2026.
Para que posso usar aisuite?
Comparar provedores ou alternar entre OpenAI, Anthropic e outros sem reescrever o código da aplicação. Criar um assistente Python que usa ferramentas e chama funções locais ou servidores MCP. Prototipar um agente com várias etapas que trabalha com os arquivos e o histórico git de um repositório de código. Executar os mesmos prompts em modelos locais do Ollama e em APIs hospedadas.
Como instalar aisuite?
Instale o pacote base aisuite do PyPI: pip install aisuite Instale o SDK do provedor que você pretende usar (por exemplo, Anthropic): pip install 'aisuite[anthropic]' Configure as chaves de API dos seus provedores seguindo o guia de início rápido do Chat Completions Crie um cliente e chame um modelo usando o formato provider:model
Onde consigo aisuite?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/andrewyng/aisuite

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados