Installation Issues

ImportError: No module named ‘hyperactive’

Cause: Hyperactive is not installed or installed in a different environment.

Solution:

pip install hyperactive

# Or with extras
pip install hyperactive[all_extras]

Verify installation:

python -c "import hyperactive; print(hyperactive.__version__)"

ImportError: cannot import name ‘Hyperactive’

Cause: You’re using v4 code with Hyperactive v5. The Hyperactive class was removed in v5.

Solution: Update your imports. See Migration Guide (v4→v5) for details.

# Old (v4)
from hyperactive import Hyperactive

# New (v5)
from hyperactive.opt.gfo import HillClimbing

Missing Optional Dependencies

Cause: Some features require additional packages.

Solution: Install the appropriate extras:

# For scikit-learn integration
pip install hyperactive[sklearn-integration]

# For Optuna backend
pip install hyperactive[optuna]

# For all extras
pip install hyperactive[all_extras]