Ambiente Virtual Dependencias e Requirements - PadawanXXVI/projeto_ams GitHub Wiki

🧰 Ambiente Virtual, Dependências e Requirements

Nesta seção da documentação do projeto, explicamos como foi criado o ambiente virtual Python, quais dependências foram utilizadas, como as bibliotecas foram registradas no requirements.txt e como garantir a reprodutibilidade do ambiente.


🧪 Criação do ambiente virtual

Para isolar o ambiente de execução e evitar conflitos entre bibliotecas, foi criado um ambiente virtual com venv:

python -m venv venv

Ativação:

  • Windows (CMD):
venv\Scripts\activate
  • Windows (PowerShell):
.\venv\Scripts\Activate.ps1
  • Linux/macOS:
source venv/bin/activate

📦 Instalação das dependências

As principais bibliotecas utilizadas foram:

  • pandas – manipulação de dados
  • numpy – operações numéricas
  • matplotlib – visualização de gráficos
  • scikit-learn – algoritmos de ML (RandomForest, SVM, MLP etc.)
  • pickle – salvamento e carregamento de modelos

Instalação:

pip install pandas numpy matplotlib scikit-learn

🧾 Geração do requirements.txt

Após instalar as dependências, utilizamos:

pip freeze > requirements.txt

Este arquivo registra as versões exatas das bibliotecas usadas no ambiente.


🔁 Versão alternativa: requirements_min.txt

Para maior compatibilidade com outros ambientes, foi criado um segundo arquivo com dependências mínimas:

pandas>=1.5
numpy>=1.21
matplotlib>=3.5
scikit-learn>=1.1

Instalação com:

pip install -r requirements_min.txt

📂 Estrutura final do repositório

projeto_ams/
├── projeto_evasao.py
├── xAPI-Edu-Data.csv
├── modelo_evasao.pickle
├── requirements.txt
├── requirements_min.txt
├── .gitignore
└── venv/ (não versionado)

✅ Conclusão

O ambiente foi configurado de forma limpa e reprodutível, com dois arquivos de dependência:

  • Um com as versões exatas (requirements.txt)
  • Um com versões mínimas e mais estáveis (requirements_min.txt)

🔙 Voltar à Home