Repolode
livekit

livekit/agents

Um framework Python para criar agentes de IA de voz e vídeo em tempo real que atuam como participantes do lado do servidor em salas do LiveKit.

Estrelas
14,887
Forks
3,979
Issues abertas
802
Último commit
há 4 horas

O que é?

Agents é um framework Python para criar participantes programáveis em tempo real que são executados em servidores. Ele permite que desenvolvedores criem agentes de voz conversacionais e multimodais capazes de ouvir, ver e responder em salas do LiveKit, conectando usuários finais aos agentes por meio de APIs de dispatch.

O framework permite combinar provedores de speech-to-text, LLM, text-to-speech e modelos em tempo real em um único pipeline. Ele inclui detecção semântica de turnos baseada em um modelo transformer para reduzir interrupções, suporte nativo a MCP para adicionar ferramentas de servidores MCP e troca de dados com clientes por meio de RPCs e APIs de dados. A integração com telefonia permite que um agente faça e receba chamadas telefônicas.

Agents pode ser executado em um terminal local para testes, em modo de desenvolvimento com hot reload ou em modo de produção. O projeto também inclui uma estrutura de testes integrada, na qual avaliadores podem verificar o comportamento dos agentes. O projeto usa a licença Apache-2.0, e a stack pode ser hospedada por conta própria junto com o servidor LiveKit.

Recursos principais

  • 01Combine provedores de STT, LLM, TTS e APIs em tempo real em um único pipeline.
  • 02Detecção semântica de turnos com um modelo transformer para reduzir interrupções.
  • 03Suporte nativo a MCP para carregar ferramentas de servidores MCP.
  • 04Integração com telefonia para fazer e receber chamadas telefônicas.
  • 05Troca de dados com clientes por meio de RPCs e APIs de dados.
  • 06Estrutura de testes integrada com avaliadores para verificar o comportamento dos agentes.

Casos de uso

  • Criar um agente de voz para suporte ao cliente que atende chamadas telefônicas.
  • Criar um agente de chamadas ativas que faz ligações automatizadas.
  • Adicionar um transcritor multiusuário para gerar transcrições para todos em uma sala.
  • Desenvolver um assistente com visão que reage a vídeos ao vivo dos usuários.

Início rápido

  1. 1

    Instale a biblioteca principal com os plugins de provedores de modelos

    pip install "livekit-agents[openai,deepgram,cartesia]"
  2. 2

    Defina as variáveis de ambiente LIVEKIT_URL, LIVEKIT_API_KEY e LIVEKIT_API_SECRET

  3. 3

    Salve o agente de exemplo como myagent.py e teste-o no modo terminal

    python myagent.py console

Antes de usar

  • O exemplo de início rápido depende do LiveKit Inference ou de chaves de API de provedores de modelos externos, que geralmente são serviços pagos.
  • Para se conectar a uma sala ao vivo, é necessária uma conta do LiveKit Cloud ou um servidor LiveKit auto-hospedado.

Tópicos

Perguntas frequentes

O que é agents?
Um framework Python para criar agentes de IA de voz e vídeo em tempo real que atuam como participantes do lado do servidor em salas do LiveKit. Agents é um framework Python para criar participantes programáveis em tempo real que são executados em servidores. Ele permite que desenvolvedores criem agentes de voz conversacionais e multimodais capazes de ouvir, ver e responder em salas do LiveKit, conectando usuários finais aos agentes por meio de APIs de dispatch.
agents é gratuito? Qual é a licença?
agents é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
agents ainda é mantido?
Manutenção ativa. O último commit de agents foi em 22 de out. de 2026.
Para que posso usar agents?
Criar um agente de voz para suporte ao cliente que atende chamadas telefônicas. Criar um agente de chamadas ativas que faz ligações automatizadas. Adicionar um transcritor multiusuário para gerar transcrições para todos em uma sala. Desenvolver um assistente com visão que reage a vídeos ao vivo dos usuários.
Como instalar agents?
Instale a biblioteca principal com os plugins de provedores de modelos: pip install "livekit-agents[openai,deepgram,cartesia]" Defina as variáveis de ambiente LIVEKIT_URL, LIVEKIT_API_KEY e LIVEKIT_API_SECRET Salve o agente de exemplo como myagent.py e teste-o no modo terminal: python myagent.py console
Onde consigo agents?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/livekit/agents

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

Projetos relacionados