Documentação Oficial

2. Primeira Execução e Permissões

Ao abrir o Treplica pela primeira vez, o assistente de configuração será exibido para preparar o ambiente:

1. Permissões de Áudio: O aplicativo solicitará acesso ao Microfone. No Windows e macOS (14.6+), o áudio do sistema é capturado nativamente para transcrever a reunião sem vazar sua voz pelo alto-falante.
2. Idioma de Transcrição: Selecione o idioma principal que você costuma utilizar em suas reuniões.
3. Provedor de Inteligência Artificial: Configure pelo menos um provedor de IA (local como Ollama ou LM Studio, ou nuvem como OpenAI, Groq, Google Gemini ou OpenRouter). Veja a seção de Configuração de IA para detalhes.
4. Preset de Assistente: Ao iniciar sua primeira sessão, escolha um perfil pré-configurado (Anotador de reunião, Assistente de vendas, Entrevista técnica ou Assistente geral) para que a IA saiba como se comportar durante a conversa.

Iniciando uma Reunião

1. Na página inicial, clique em Analisar conversa.
2. Siga as 6 etapas do modal (barra de progresso no topo): áudio/idioma → microfone → áudio do sistema → captura de tela → assistente → contexto opcional.
3. Use Continuar em cada etapa; os testes de áudio e captura são obrigatórios no app desktop antes de Iniciar sessão.
4. Clique em Iniciar sessão. O Treplica abre o overlay stealth (ou a janela ao vivo, se o overlay não estiver disponível).

Para mudar idioma ou modo de áudio, encerre a sessão e abra o modal novamente — durante a gravação o app só mostra um resumo das preferências escolhidas.

Presets de Assistente

Na etapa Assistente do modal, você escolhe um perfil pré-configurado que define o comportamento da IA durante a sessão. Cada preset tem um papel, objetivo e tom otimizados para o contexto.

Você pode personalizar qualquer preset ou criar contextos totalmente manuais na etapa Contexto.

Contexto da Sessão

O contexto ajusta como a IA gera sugestões. Quanto mais informações você fornecer, mais precisas e relevantes serão as orientações. Todos os campos são opcionais.

Categorias de Orientação

As sugestões geradas pela IA são classificadas em categorias. Você pode filtrar por categoria no painel de orientações durante a sessão.

Depois da Reunião

Quando a reunião terminar, encerre a sessão. Ela será salva automaticamente no seu Histórico local. Você também pode buscar sessões antigas por palavras-chave no histórico.

• Acesse o Histórico para rever a transcrição completa.
• Na aba Documentos, solicite à IA que gere um dos seguintes tipos de documento:
  • Resumo — síntese executiva dos pontos discutidos
  • Follow-up — e-mail de acompanhamento com próximos passos
  • Notas — anotações estruturadas da reunião
  • Transcrição — exportação completa do texto transcrito
• Todos os documentos podem ser exportados como Markdown (.md) ou copiados para a área de transferência.

IA Local — Máxima Privacidade

Se você possui um computador com boa placa de vídeo (GPU) ou um Mac M1/M2/M3, recomendamos o Ollama. Tudo roda offline. O LM Studio também é suportado para quem prefere interface gráfica.

IA na Nuvem

Serviços na nuvem são ideais se você não tem hardware potente ou precisa das respostas mais inteligentes possíveis. Eles requerem chaves de API pagas pelo uso.

Como configurar:

• Vá em Configurações → Provedores e selecione o provedor desejado.
• Insira sua API Key. Ela é armazenada cifrada no Cofre nativo do Sistema Operacional (Keyring/Keychain) e nunca exposta em texto plano.
• Para provedores na nuvem, certifique-se de que o modo de privacidade permite conexões externas (veja Privacidade e Stealth).

Roteamento de Modelos por Tarefa

Em Configurações → Roteamento de modelos, você pode designar provedores diferentes para cada tipo de tarefa. Isso permite combinar, por exemplo, o Groq (rápido e barato) para transcrição com o GPT-4o (mais inteligente) para orientações em tempo real.

Se nenhum provedor for especificado para uma tarefa, o Treplica usa o primeiro provedor ativo disponível.

Prioridade: latência baixa e precisão em português. Modelos Whisper são os mais indicados. O Groq oferece o melhor custo-benefício para STT em nuvem.

Prioridade: velocidade de resposta — quanto mais rápido, menos você interrompe o fluxo da conversa. Modelos menores (7B–8B) com inferência rápida são preferíveis a modelos grandes lentos.

Prioridade: velocidade e custo. A tradução acontece em paralelo à transcrição, então modelos leves são preferíveis. Pares de idiomas que incluem português funcionam bem com modelos menores.

Prioridade: suporte a visão (multimodal) é obrigatório. Nem todos os modelos aceitam imagens — use modelos explicitamente multimodais. Requer um provedor diferente do STT, configurado separadamente em Roteamento de modelos.

Prioridade: qualidade e raciocínio. Esta tarefa não é em tempo real — acontece após a sessão. Modelos maiores e mais capazes produzem documentos mais ricos. Latência alta é aceitável.

Combinações Recomendadas

Para quem quer começar rápido, estas três combinações cobrem os casos de uso mais comuns:

Onde Fica o Teste

As verificações aparecem nas etapas 2, 3 e 4 do modal Analisar conversa (barra de progresso no topo). Cada etapa tem um botão de gravação individual e um indicador de nível de áudio em tempo real.

🎤 Etapa 2 — Microfone (opcional)

Grava 4 segundos de áudio do microfone selecionado pelo sistema operacional e exibe uma prévia para ouvir antes de continuar.

1. Clique em Gravar teste (4s). O app solicita permissão de microfone, se necessário.
2. O indicador de barra mostra o nível em tempo real durante os 4 segundos.
3. Ouça a prévia de áudio para confirmar que sua voz foi captada com clareza.
4. Se o nível estiver muito baixo, aproxime-se do microfone e clique Gravar de novo.

🔊 Etapa 3 — Áudio do Sistema

Captura o som que sai pelos alto-falantes ou fones — ou seja, o que os outros participantes falam na chamada. O método de captura varia conforme o sistema operacional:

🖥️ Etapa 4 — Captura de Tela

Verifica que o Treplica consegue tirar snapshots da tela para análise visual pela IA (envio de imagem ao modelo de visão via atalho durante a sessão).

1. Selecione o monitor desejado (ou deixe em "Automático" para o monitor principal).
2. Clique em Testar captura. Uma miniatura da tela aparece como prévia.
3. Se a prévia aparecer corretamente, a captura está OK.

Teste de Transcrição no Onboarding

Na tela de configuração inicial, há um painel de teste de transcrição independente dos preflight checks acima. Ele confirma que o provedor de STT está funcionando corretamente.

1. Selecione o idioma (Auto-detect, Português BR, English US, Español, ou descreva um idioma personalizado).
2. Pressione Ctrl+D ou clique no botão de microfone para iniciar a gravação.
3. Fale algumas frases. A transcrição aparece em tempo real na área de texto.
4. Pressione o atalho novamente para enviar ao provedor de IA e ver a resposta.

O atalho de envio varia conforme a plataforma e é exibido no rodapé do painel de teste.

Tamanho do Texto

Existem dois controles de escala de fonte independentes: um para o aplicativo principal e outro para o overlay (janela discreta). Isso permite, por exemplo, usar texto grande no overlay sem alterar o restante da interface.

As alterações de escala têm efeito imediato — não é necessário reiniciar o aplicativo.

Opções de Exibição

Como Verificar e Instalar Atualizações

1. Acesse Configurações → Atualizações.
2. Clique em Verificar atualizações. O app consulta o servidor de releases e exibe:
   • Versão atual instalada no seu dispositivo.
   • Última versão disponível para download (se houver uma versão mais nova).
   • Notas de versão com o que mudou na nova release.
3. Se uma atualização estiver disponível, o botão Instalar v[versão] aparece. Clique para iniciar o download e a instalação.
4. O app solicita confirmação antes de aplicar. Após a instalação, reinicie o Treplica para usar a nova versão.

O Que Fica na Sua Máquina

• ✓Áudio e Transcrições: Gravados temporariamente e processados no seu computador ou enviados diretamente para a API (ex: OpenAI) que VOCÊ configurou.
• ✓Histórico e Documentos: Salvos no banco de dados local SQLite (treplica.db).
• ✓Chaves de API: Guardadas no Cofre do Sistema Operacional (Keyring/Keychain), nunca em texto plano.

Arquivos e Retenção

Em Configurações → Arquivos e backup, você define para onde seus documentos exportados (Markdown) devem ir. Você pode sincronizá-los diretamente com seu OneDrive, Google Drive ou pasta segura.

Se você excluir uma sessão pelo aplicativo, todos os registros relacionados no banco de dados e arquivos gerados (resumos, e-mails) serão apagados permanentemente do disco.