Olá! Este é um projeto de um chatbot da ecologia por nome EcoIA que foi desenvolvido pelos alunos do IF Baiano - Campus Guanambi.
São eles: 

Adriel Lima	Luiz Eduardo Lopes	Vinícius Morais

---

Instruções para Rodar o Projeto

Para configurar e rodar o chatbot EcoIA no seu ambiente local, siga os passos abaixo.

Pré-requisitos

Certifique-se de ter os seguintes softwares instalados antes de iniciar:

• Python 3.12: Baixe aqui
• VS Code: Baixe aqui
• XAMPP: Baixe aqui
• MySQL Workbench 8.0 CE: Baixe aqui
• Conta Google com API Key para o Gemini: Obtenha aqui

Configuração do Ambiente

1. Baixe e Abra o Projeto:

   • Clone ou baixe o repositório do GitHub para o seu computador.

   • Caso BAIXE, recomendamos renomear a pasta para chatbot.

   • Para abrir o projeto no VS Code, selecione a pasta chatbot e clique com o botão direito. Vá em "Mostrar mais opções" e depois em "Abrir com Code".
     
     
     

   • Ao abrir, confirme a confiança nos autores da pasta, se solicitado:
     
     
     

   • Caso CLONE, crie uma pasta para o nome chatbot para depois fazer os processos ensinados anteriormente de "Abrir com Code".
     

   • No terminal, que tem a seguir um tutorial de como abrir, com ele aberto cole o seguinte código antes de fazer qualquer coisa:

     git clone https://github.com/driizin/EcoIA.git

     

   • Logo após, para não ocorrer nenhum erro, transfira todos os arquivos criados pela pasta EcoIA para a pasta chatbot e, em seguida, exclua a pasta EcoIA:
     
     
     
     

2. Abra o Terminal no VS Code:

   • No VS Code, abra o arquivo main.py no lado esquerdo.
     
   • Vá na parte superior do aplicativo e selecione Terminal > Novo Terminal.
     
     
     
     

3. Crie e Ative o Ambiente Virtual:

   • Para criar um ambiente virtual chamado EcoIA (recomendado para isolar as dependências do projeto), execute:

     py -3.12 -m venv EcoIA

     

   • Ative o ambiente virtual. Você deve ver (EcoIA) no início da linha de comando. Os comandos de ativação variam de acordo com o sistema operacional:

     • No Windows (CMD/PowerShell):

       .\EcoIA\Scripts\activate

       
     • No Linux / macOS (Bash/Zsh):

       source EcoIA/Scripts/activate

       

   • Verifique se o VS Code está usando o interpretador Python correto (Python 3.12 do ambiente EcoIA). Ele aparece no canto inferior direito. Se não estiver, clique nele e selecione "Python 3.12.0 ('EcoIA':venv)".
     
     

4. Instale as Dependências do Projeto: Com o ambiente virtual EcoIA ativado, instale todas as bibliotecas Python necessárias para o projeto. O arquivo requirements.txt garante que todas as dependências (incluindo os modelos de linguagem do SpaCy) sejam instaladas nas versões exatas, assegurando a compatibilidade e a funcionalidade do chatbot.

   No terminal, execute:

   pip install -r requirements.txt

Configuração do Banco de Dados MySQL

1. Inicie o Servidor MySQL via XAMPP:

   • Abra o XAMPP Control Panel.
     
     
   • Clique no botão Start ao lado de "MySQL" para iniciar o serviço do banco de dados.
     

2. Crie o Banco de Dados com o MySQL Workbench:

   • Na pasta do seu projeto chatbot, localize e abra a pasta sgbd.
     
     
   • Abra o arquivo chatbot.sql com o MySQL Workbench.
     
     
     
   • Dentro do MySQL Workbench, execute o script SQL clicando no ícone de "raiozinho" (destacado em azul).
     
     
   • A execução bem-sucedida será confirmada na seção "Output" na parte inferior, com símbolos verdes.
     

Configuração da API do Google Gemini

1. Obtenha sua Chave de API:

   • Acesse o Google AI Studio e clique em "Criar chave de API".
     
     
   • No campo "Pesquisar projetos do Google Cloud", selecione o projeto do Gemini API.
     
     
   • Sua chave de API aparecerá. Copie-a.

   
   OBSERVAÇÃO IMPORTANTE: ⚠️ TENHA MUITO CUIDADO COM ESSA CHAVE! Se alguém obtiver sua chave de API, poderá ter acesso à sua conta Google e potencialmente a informações confidenciais, além de gerar custos indevidos. Mantenha-a em segurança! ⚠️
   
   

2. Configure a Variável de Ambiente:

   • Pesquise no Windows por "Variáveis de Ambiente" (ou "Editar as variáveis de ambiente do sistema").
     
     
   • Na janela de Propriedades do Sistema, clique em "Variáveis de Ambiente...".
     
     
   • Na seção "Variáveis de usuário" (ou "Variáveis do sistema", se preferir que seja para todos os usuários), clique em "Novo...".
     
     
   • No campo "Nome da variável", insira: GOOGLE_GEMINI_API_KEY
   • No campo "Valor da variável", cole sua chave de API (sem aspas).
   • Clique em OK em todas as janelas para salvar as alterações.
   • Reinicie o computador para que a nova variável de ambiente seja reconhecida pelo sistema.

Rodando o Chatbot

1. Inicie o Servidor do Chatbot:

   • Com todas as configurações anteriores feitas e seu ambiente virtual EcoIA ativado no terminal do VS Code:
   • Aperte no botão de "Play" para rodar o arquivo.
     

2. Acesse o Chatbot no Navegador:

   • Após iniciar o servidor, o terminal indicará o endereço local onde o chatbot está rodando. Geralmente, será: http://127.0.0.1:5000
     
   • Abra seu navegador e acesse esse endereço.

Demonstração do Chatbot

Assista a uma breve demonstração do EcoIA em ação:

---

11. Aproveite e teste o nosso chatbot EcoIA!!!