EvidenceFlow

Automatiza a criação de vídeos tutoriais de QA a partir de PDFs. Usa IA para analisar evidências, gerar roteiro, criar narração em português e sincronizar com gravação de tela. Tudo em uma interface web simples e intuitiva.

Demo

Acesse o projeto: Clone o repositório e siga as instruções abaixo.

O que faz

• Analisa PDFs de evidência QA e identifica elementos destacados
• Gera roteiro narrativo automaticamente
• Converte o roteiro em áudio (português brasileiro)
• Permite gravação de tela com áudio sincronizado
• Combina vídeo + áudio em um único arquivo

Tecnologias

• Backend: Python, Flask, LangGraph
• IA: Google Gemini 2.5 Flash (análise visual)
• TTS: Edge-TTS (narração)
• Frontend: HTML, Tailwind CSS, JavaScript
• Vídeo: MediaRecorder API, FFmpeg

Instalação

Pré-requisitos

• Python 3.11 ou superior
• FFmpeg (para combinação de vídeo/áudio)
• Chave da API do Google Gemini

Passo a passo

1. Clone o repositório:

git clone https://github.com/seu-usuario/evidenceflow.git
cd evidenceflow

2. Crie e ative o ambiente virtual:

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

3. Instale as dependências:

pip install -r requirements.txt

4. Configure a API key:

cp .env.example .env

Edite o arquivo .env e adicione sua chave do Gemini:

GEMINI_API_KEY=sua_chave_aqui

Obtenha sua chave em: https://makersuite.google.com/app/apikey

5. Instale o FFmpeg:

• Windows: https://ffmpeg.org/download.html
• Linux: sudo apt install ffmpeg
• Mac: brew install ffmpeg

Como usar

1. Inicie o servidor:

python run_frontend.py

2. Acesse no navegador:

http://localhost:5000

3. Fluxo de trabalho:
   • Faça upload do PDF de evidência
   • Aguarde a análise automática
   • Edite o roteiro (opcional)
   • Gere o áudio
   • Grave o vídeo (contagem regressiva de 5s)
   • Baixe o resultado

Estrutura do projeto

evidenceflow/
├── frontend/              # Aplicação web
│   ├── app.py            # Backend Flask
│   ├── templates/        # Interface HTML
│   └── static/           # CSS e JavaScript
├── src/
│   ├── models/           # Modelos de dados
│   ├── nodes/            # Processamento (análise, roteiro, áudio)
│   └── graph/            # Workflow LangGraph
└── requirements.txt      # Dependências

Funcionalidades

Análise de PDF

Identifica automaticamente elementos destacados (caixas laranjas/amarelas) em screenshots de interface e gera descrições dos passos.

Editor de Roteiro

Interface intuitiva com textareas que expandem automaticamente. Permite editar introdução, passos e conclusão antes de gerar o áudio.

Gravação Sincronizada

Contagem regressiva visual (5 segundos) antes de iniciar. O áudio começa automaticamente junto com a gravação de tela.

Combinação de Mídia

Merge automático de vídeo gravado + áudio gerado usando FFmpeg, resultando em um arquivo MP4 final.

Formato do PDF

O sistema espera PDFs com:

• Screenshots de interface
• Elementos destacados com caixas coloridas (laranja/amarelo)
• Texto explicativo para cada passo

Contribuindo

Pull requests são bem-vindos. Para mudanças maiores, abra uma issue primeiro para discutir o que você gostaria de mudar.

Licença

MIT

Contato

Desenvolvido por Lucas Rodrigues Fedrigo

LinkedIn
Email: lucasffedrigo@gmail.com

---

⭐ Se este projeto foi útil, considere dar uma estrela!