📦 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:

1. Quick Start Guide

Follow our Quick Start Guide to run your first optimization in minutes.

2. Try Examples

Explore the Simple Example to understand the basic concepts.

3. Read Documentation

Check out the API Reference for detailed information about classes and methods.