omenathiago/flashcards-voice-chat

🗣️ Flashcards Voice Chat (Bob - Professor Virtual de Inglês)

Este é um chatbot de voz em Português e Inglês usando modelos da Hugging Face. Ele permite conversas naturais com áudio de entrada e saída.

🚀 Como funciona

1. 1.Clique em Iniciar Conversa
2. 2.O bot (Bob) se apresenta em português.
3. 3.Pergunta se você quer repassar frases ou conversar em inglês.

1. 1.Quando aparecer o botão Falar, grave sua fala.
2. 2.O áudio será transcrito pelo Whisper (Hugging Face).
3. 3.O texto será enviado ao modelo de chat Falcon-7B-Instruct.
4. 4.A resposta será convertida em áudio (TTS).

1. 1.O botão alterna automaticamente entre Falar e Ouvir.

1. 1.Clique em Finalizar Conversa para encerrar.

🔑 Configuração de Secrets no Hugging Face

Este projeto precisa de um token de API da Hugging Face.

1. 1.Vá até a página do seu Space.
2. 2.Clique em Settings → Repository secrets.
3. 3.Adicione um novo secret:

• —Name: HF_API_KEY
• —Value: cole seu token da Hugging Face

Você pode gerar um token aqui. O token precisa ter pelo menos permissão read para usar modelos.

📦 Deploy local

Se quiser testar antes:

pip install -r requirements.txt
python app.py