Troubleshooting
This guide helps you diagnose and fix common issues with Gradient-Free-Optimizers. If you don’t find a solution here, see Getting Help for support options.
Overview
- Installation Problems
Import errors, missing modules, dependency conflicts, and version compatibility.
- Runtime Errors
AttributeError, TypeError, ValueError, and other runtime errors during optimization.
- Performance Problems
Slow optimization, high memory usage, and performance bottlenecks.
- Result Problems
Unexpected results, local optima, reproducibility issues, and score problems.
- Getting Help
Where to get additional support and how to report issues.
Quick Diagnosis
Check Python version (needs 3.10+),
verify installation with pip list | grep gradient
Check search space definition, objective function signature, and parameter types
Profile objective function, reduce search space size, or choose faster algorithm
Verify maximization vs. minimization, check search space bounds, increase iterations