Installation Guide
📦 Installation
Get up and running with MAT-HPO in minutes:
bash
# Clone the repository
git clone https://github.com/VM230705/MAT-HPO-Library.git
cd MAT-HPO-Library
# Install dependencies
pip install torch numpy scikit-learn
# Test the installation
python test_working_examples.py
System Requirements
Minimum Requirements
- Python: 3.8 or higher
- RAM: 4GB minimum (8GB recommended)
- Disk Space: 100MB for library
- OS: Linux, macOS, Windows
Recommended Setup
- Python: 3.10+
- GPU: CUDA-compatible GPU (for faster training)
- RAM: 16GB+ for large optimization tasks
- CPU: Multi-core processor for parallel optimization
Dependencies
Core Dependencies
bash
# Core ML/DL dependencies
pip install torch>=2.0.0
pip install numpy>=1.20.0
pip install scikit-learn>=1.0.0
# Optional but recommended
pip install tqdm # Progress bars
pip install wandb # Experiment tracking
pip install matplotlib # Plotting
pip install seaborn # Enhanced plotting
GPU Support (Optional)
bash
# For CUDA support (check your CUDA version)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
# Verify GPU support
python -c "import torch; print('CUDA Available:', torch.cuda.is_available())"
Installation Methods
Method 1: Git Clone (Recommended)
bash
# Clone the repository
git clone https://github.com/VM230705/MAT-HPO-Library.git
cd MAT-HPO-Library
# Add to Python path for development
export PYTHONPATH=$PYTHONPATH:$(pwd)
Method 2: Development Installation
bash
# Clone and install in development mode
git clone https://github.com/VM230705/MAT-HPO-Library.git
cd MAT-HPO-Library
pip install -e .
# This allows you to modify the code and see changes immediately
Verify Installation
Quick Test
python
# Test basic imports
import sys
sys.path.insert(0, '.')
from MAT_HPO_LIB import MAT_HPO_Optimizer, BaseEnvironment, HyperparameterSpace
print("✅ MAT-HPO Library imported successfully!")
Run Test Suite
bash
# Run the comprehensive functionality test
python test_working_examples.py
# Expected output:
# MAT-HPO Library Simple Functionality Test
# ==================================================
# Testing imports...
# ✅ Core imports successful
# ...
# Test Results: 5/5 tests passed
# All functionality tests passed!
Next Steps
Now that you have MAT-HPO installed, here's what to do next: