Tópico sobre o projeto LiveKit `lk_agente_v3` — agente de voz com…
INEMA
No seu código agent.py, o LLM (modelo de linguagem) está configurado nesta linha:
llm=openai.LLM(model="gpt-4o-mini"),
Essa linha define o modelo GPT-4o-mini da OpenAI como o gerador de texto. Para trocar e usar o DeepSeek via OpenRouter, substitua esse trecho por um cliente HTTP simples que envia requisições à API do OpenRouter.
Exemplo direto para o seu LiveKit:
```import requests import os
class OpenRouterLLM: def init(self): self.api_key = os.getenv("OPENROUTER_API_KEY") self.model = "deepseek/deepseek-chat"
async def generate(self, prompt: str):
url = "https://openrouter.ai/api/v1/chat/completions"
headers = {
"Authorization": f"Bearer {self.api_key}",
"Content-Type": "application/json"
}
payload = {
"model": self.model,
"messages": [{"role": "user", "content": prompt}]
}
response = requests.post(url, headers=headers, json=payload)
return response.json()["choices"][0]["message"]["content"]
No AgentSession:⌗
session = AgentSession( stt=deepgram.STT(model="nova-2", language="pt-BR"), llm=OpenRouterLLM(), # usa DeepSeek via OpenRouter tts=tts_cartesia )```
E adicione no seu .env:
OPENROUTER_API_KEY=sk-sua-chave-do-openrouter
Assim o assistente passa a usar DeepSeek (via OpenRouter) como LLM principal, mantendo o STT (Deepgram) e o TTS (Cartesia.ai).
Se quiser mudar para outra llm
O ID da voz clonada da Cartesia.ai foi colocado dentro da função tts_cartesia, exatamente nesta linha:
voice="a8a62b0a-4c41-471a-a338-033053aa8219", # sua voz clonada
Ela está localizada dentro deste trecho do código:
async def tts_cartesia(texto: str) -> bytes:
"""Gera áudio em português com voz clonada da Cartesia.ai."""
logger.info("Gerando áudio com Cartesia.ai (voz clonada)...")
audio_bytes = cartesia.tts.speak(
voice="a8a62b0a-4c41-471a-a338-033053aa8219", # sua voz clonada
text=texto,
format="wav",
language="pt-BR"
)
return audio_bytes
Essa é a parte que define qual voz será usada pelo TTS da Cartesia.ai.
Você pode alterar esse valor a qualquer momento para outro voice_id da sua conta Cartesia sem precisar mexer no resto do código.
Se quiser, posso adaptar o código para ler esse voice_id diretamente do .env, permitindo trocar a voz sem editar o script. Deseja que eu faça isso?
Dica para mudar a voz para cartesia.ai
Pode depois de fazer funcionar pedir para o claude adicionar pesquisa web ou outros servicos. (3 dias antes desse video falei mais sobre o Livekit
https://www.youtube.com/watch?v=_HfhyzaLpEs
Esse link leva à página LiveKit Agents Playground — uma interface para conectar agentes via LiveKit (usar LiveKit Cloud ou manualmente com URL + token) (agents-playground.livekit.io)
Aqui está o passo a passo completo para instalar e rodar o projeto lk_agente_v3 do seu repositório no GitHub:
1. Baixar o projeto⌗
- Acesse: https://github.com/inematds/lk_agente_v3
- Clique em Code → Download ZIP
- Copie o arquivo
download.zippara um diretório local no seu computador (exemplo:C:\lk_agente_v3) - Extraia o conteúdo do ZIP (clique com o botão direito → “Extrair aqui”)
2. Configurar as chaves no arquivo .env⌗
- Dentro da pasta extraída, existe um arquivo chamado .env.exemplo
- Copie e renomeie ele para .env
- Abra o arquivo
.envcom o Bloco de Notas e substitua as chaves pelas suas:
LIVEKIT_URL=ws://localhost:7880
LIVEKIT_API_KEY=sua_key
LIVEKIT_API_SECRET=sua_secret
OPENAI_API_KEY=sk-...
DEEPGRAM_API_KEY=...
Essas chaves vêm das seguintes plataformas:
- https://cloud.livekit.io/ → para
LIVEKIT_API_KEYeLIVEKIT_API_SECRET - https://deepgram.com/ → para
DEEPGRAM_API_KEY - https://platform.openai.com/ → para
OPENAI_API_KEY
3. Instalar as dependências⌗
- Dentro da pasta do projeto, execute o setup.bat (duplo clique ou clique direito → “Executar como administrador”)
- Esse script instala os pacotes necessários (Python, dependências e ambiente virtual)
4. Iniciar o agente⌗
- Após a instalação, execute o start.bat Isso inicializa o agente LiveKit localmente.
5. Corrigir erros (caso ocorram)⌗
-
Se algo falhar durante o setup ou start:
-
Abra o projeto diretamente no Claude Code (ou VS Code com Claude integrado)
- Peça: “Conserte o erro de instalação ou execução do lk_agente_v3.”
- O Claude ajustará os pacotes ou caminhos automaticamente.
6. Dica adicional⌗
Se estiver rodando localmente com LiveKit, garanta que o servidor esteja ativo:
- Use
ws://localhost:7880apenas se você iniciou o servidor LiveKit localmente. Caso contrário, substitua pela URL do LiveKit Cloud:
LIVEKIT_URL=wss://seu_projeto.livekit.cloud
github.com/inematds/lk_agente_v3 ↗
LiveKit v3 -GitHub Repositorio
1