Quick Installation Verification

Verify that MAT-HPO Library is correctly installed and working with these simple test commands.

Method 1: Working Examples Test (Recommended)

The fastest way to verify your installation - runs multiple examples to test core functionality:

bash 
# Run comprehensive working examples
python test_working_examples.py

What this tests:

  • ✅ Basic classification optimization
  • ✅ FullControlHPO production interface
  • ✅ EasyHPO simplified interface
  • ✅ ECG time series classification

Method 2: LLM Functionality Test

Test the advanced LLM-enhanced optimization features:

bash 
# Test LLM integration and advanced features
python -m pytest MAT_HPO_LIB/tests/test_llm_functionality.py -v

What this tests:

  • ✅ LLM client connections
  • ✅ Hyperparameter mixing strategies
  • ✅ Adaptive alpha controllers
  • ✅ Time series analysis pipelines

Method 3: Core Library Test

Test the fundamental MAT-HPO optimization algorithms:

bash 
# Test core optimization algorithms and multi-agent system
python -m pytest MAT_HPO_LIB/tests/test_library.py -v

What this tests:

  • ✅ Multi-agent SQDDPG algorithms
  • ✅ Hyperparameter space definitions
  • ✅ Optimization configurations
  • ✅ Environment interfaces

⚡ Method 4: Quick Python Test

Test a single function import to verify basic installation:

python 
# Quick import test
try:
    from MAT_HPO_LIB import EasyHPO, FullControlHPO
    print("✅ MAT-HPO Library imported successfully!")
    print(f" Available interfaces: EasyHPO, FullControlHPO")
except ImportError as e:
    print(f"❌ Import failed: {e}")

✅ Expected Output

If everything is working correctly, you should see output similar to:

text 
Testing MAT-HPO-Library examples...
 Starting basic classification optimization...
✅ Best F1: 0.8949
 Starting FullControlHPO optimization...
✅ FullControlHPO F1: 0.8949
 Starting EasyHPO LLM optimization...
✅ EasyHPO F1: 0.8949
❤️ Starting ECG classification optimization...
✅ ECG F1: 0.8762
✅ All examples work correctly!

Troubleshooting

Common Issues:

  • Import Errors: Ensure all dependencies are installed: pip install torch numpy scikit-learn
  • CUDA Issues: The library automatically detects and uses GPU if available, falls back to CPU
  • LLM Tests Failing: LLM features require local Ollama installation for full functionality

All Test Commands Summary

bash 
# Method 1: Comprehensive examples (recommended)
python test_working_examples.py

# Method 2: LLM functionality test
python -m pytest MAT_HPO_LIB/tests/test_llm_functionality.py -v

# Method 3: Core library test
python -m pytest MAT_HPO_LIB/tests/test_library.py -v

Next Steps

Quick Start Guide

Learn how to use MAT-HPO for your own optimization problems

EasyHPO Examples

Complete working examples with real datasets

FullControlHPO API

Production-grade interface used in research applications