Repolode
Enviar
bubbuild

bubbuild/republic

Biblioteca Python que oferece uma única interface para chat, streaming, chamadas de ferramentas e saídas estruturadas em diferentes provedores de IA.

Ver no GitHubSite
Estrelas
84
Forks
23
Issues abertas
0
Último commit
há 5 dias

O que é?

Republic é uma biblioteca Python que reúne vários provedores de modelos de IA em uma única interface. Você seleciona um modelo com uma string `provider:model`; assim, para trocar entre serviços como OpenAI, Anthropic, Google ou DeepSeek, basta mudar esse nome. Cada provedor lê sua chave de API de uma variável de ambiente `REPUBLIC_<PROVIDER>_API_KEY`.

A biblioteca oferece conclusão de chat, respostas em streaming como eventos tipados, chamadas de ferramentas e saídas estruturadas. Seu escopo se limita à camada de provedores: loops de agentes, execução de ferramentas e gateways ficam a cargo da aplicação. Um middleware assíncrono opcional pode observar e reescrever os eventos de cada chamada, por exemplo, para adicionar novas tentativas.

A documentação também aborda entrada de mídia, embeddings, geração de imagens, modelos de decisão, histórico de conversas e provedores personalizados. Requer Python 3.11 ou posterior.

Recursos principais

  • 01Troque de provedor alterando o nome `provider:model`.
  • 02Respostas em streaming entregues como eventos tipados.
  • 03Chamadas de ferramentas e saídas estruturadas por meio de uma única API.
  • 04Middleware assíncrono opcional para observar ou reescrever chamadas e novas tentativas.
  • 05Compatível com embeddings, geração de imagens e provedores personalizados.

Casos de uso

  • Desenvolver uma aplicação que precisa funcionar com vários provedores de LLM.
  • Adicionar chat em streaming ou chamadas de ferramentas a um serviço Python sem vincular o código a um único fornecedor.
  • Criar seu próprio loop de agente sobre um cliente independente de provedor.

Início rápido

  1. 1

    Instale o Republic com pip

    python -m pip install republic
  2. 2

    Defina sua chave de API da OpenAI nas variáveis de ambiente

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

    Execute o exemplo em Python que chama um modelo com chat e streaming

Antes de usar

  • Requer Python 3.11 ou posterior.
  • Cada provedor precisa da própria chave de API ou de um login.

Em coleções

Ferramentas de streaming

Tópicos

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

Perguntas frequentes

O que é republic?
Biblioteca Python que oferece uma única interface para chat, streaming, chamadas de ferramentas e saídas estruturadas em diferentes provedores de IA. Republic é uma biblioteca Python que reúne vários provedores de modelos de IA em uma única interface. Você seleciona um modelo com uma string `provider:model`; assim, para trocar entre serviços como OpenAI, Anthropic, Google ou DeepSeek, basta mudar esse nome. Cada provedor lê sua chave de API de uma variável de ambiente `REPUBLIC_<PROVIDER>_API_KEY`.
republic é gratuito? Qual é a licença?
republic é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
republic ainda é mantido?
Manutenção ativa. O último commit de republic foi em 2 de nov. de 2026.
Para que posso usar republic?
Desenvolver uma aplicação que precisa funcionar com vários provedores de LLM. Adicionar chat em streaming ou chamadas de ferramentas a um serviço Python sem vincular o código a um único fornecedor. Criar seu próprio loop de agente sobre um cliente independente de provedor.
Como instalar republic?
Instale o Republic com pip: python -m pip install republic Defina sua chave de API da OpenAI nas variáveis de ambiente: export REPUBLIC_OPENAI_API_KEY="your-api-key" Execute o exemplo em Python que chama um modelo com chat e streaming
Onde consigo republic?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/bubbuild/republic

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

Projetos relacionados