Um harness de agentes para Python, com escolhas opinativas e tudo incluído, que executa tarefas longas e com várias etapas desde o início no LangGraph.
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
Instale o pacote base aisuite do PyPI
pip install aisuite - 2
Instale o SDK do provedor que você pretende usar (por exemplo, Anthropic)
pip install 'aisuite[anthropic]' - 3
Configure as chaves de API dos seus provedores seguindo o guia de início rápido do Chat Completions
- 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
SDK oficial de Python para criar servidores e clientes do Model Context Protocol que conectam aplicações com LLMs a ferramentas, dados e prompts.
Sistema de memória para agentes que armazena, recupera e reflete sobre memórias para que agentes de IA aprendam com o tempo, em vez de apenas reproduzir o histórico de conversas.
Framework Python para criar servidores MCP, clientes e apps interativos que conectam LLMs a ferramentas e dados.
Infraestrutura de memória nativa para agentes, que transforma conversas e execuções de agentes LLM em memória persistente e estruturada para apps em Python e TypeScript.
Um framework de agentes que conecta humanos digitais (2.5D, 3D, mobile, PC e web) e LLMs (compatíveis com OpenAI e DeepSeek) a sistemas de negócios.