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 dadosnumpy
– operações numéricasmatplotlib
– visualização de gráficosscikit-learn
– algoritmos de ML (RandomForest, SVM, MLP etc.)pickle
– salvamento e carregamento de modelos
Instalação:
pip install pandas numpy matplotlib scikit-learn
requirements.txt
🧾 Geração do Após instalar as dependências, utilizamos:
pip freeze > requirements.txt
Este arquivo registra as versões exatas das bibliotecas usadas no ambiente.
requirements_min.txt
🔁 Versão alternativa: 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
)