Gerador de Relatórios com LLM

Este projeto é um serviço web desenvolvido em Flask que permite gerar relatórios detalhados. Ele utiliza um Modelo de Linguagem Grande (LLM) como o Gemini para processar informações de um documento de referência, arquivos de contexto e requisitos fornecidos em linguagem natural, resultando em um documento DOCX final.

Estrutura do Projeto

A pasta do projeto possui a seguinte organização:

• app.py: O código-fonte do backend Flask, responsável pela lógica de geração do relatório.
• index.html: Um arquivo HTML simples que serve como interface de usuário (frontend) para interagir com a API.
• input_relatorio.json: Um arquivo JSON que define a estrutura de dados esperada para os requisitos do relatório, servindo como um "schema" para o LLM.
• requirements.txt: Lista todas as bibliotecas e dependências Python necessárias para o projeto.

Pré-requisitos

Antes de iniciar a aplicação, certifique-se de ter os seguintes softwares instalados em seu sistema:

• Python 3.8 ou superior: Download do Python
• Chave da API do Google Gemini: Obtenha gratuitamente em ai.google.dev

Configuração do Ambiente Local

1. Obtenha o Código-Fonte

Se você recebeu o projeto como uma pasta, pule para o próximo passo. Caso contrário, clone o repositório:

git clone <URL_DO_SEU_REPOSITORIO>
cd <nome_da_pasta_do_projeto>

2. Crie e Ative um Ambiente Virtual

python -m venv venv

Ativação:

• Windows (Prompt de Comando): .�env\Scripts�ctivate
• Windows (PowerShell): .�env\Scripts\Activate.ps1
• macOS/Linux: source venv/bin/activate

3. Instale as Dependências

pip install -r requirements.txt

4. Configure a Chave da API do Gemini

Defina a variável de ambiente GEMINI_API_KEY com o valor da sua chave:

• Windows (Prompt de Comando): set GEMINI_API_KEY="SUA_CHAVE_DA_API_AQUI"
• Windows (PowerShell): $env:GEMINI_API_KEY="SUA_CHAVE_DA_API_AQUI"
• macOS/Linux: export GEMINI_API_KEY="SUA_CHAVE_DA_API_AQUI"

Como Rodar a Aplicação

Certifique-se de que o ambiente virtual está ativado e execute:

python app.py

A aplicação estará disponível em:

http://127.0.0.1:5000

Acessando no Navegador

Abra seu navegador e acesse: http://127.0.0.1:5000

Testando a API Diretamente (Opcional)

Você pode fazer uma requisição POST para /generate-report com curl, Postman ou Insomnia.

Exemplo de uso com curl:

curl -X POST http://127.0.0.1:5000/generate-report \
  -H "Content-Type: multipart/form-data" \
  -F "referencia=@./caminho/para/seu/arquivo_referencia.docx" \
  -F "contextos=@./caminho/para/seu/arquivo_contexto1.pdf" \
  -F "contextos=@./caminho/para/seu/imagem_contexto.png" \
  -F "requisitos=Gere um relatório detalhado sobre a prospecção de ouro na área X..." \
  -o relatorio_gerado.docx

Substitua os caminhos e requisitos pelos adequados ao seu caso.

---

Divirta-se explorando o projeto! Em caso de dúvidas, verifique os logs no terminal.