Troubleshooting

Common Issues

• ImportError: ensure virtual environment is activated and package installed.
• Plot GUI errors in CI: use headless backend via utils.plotting.use_headless_backend("Agg").
• Type errors: run ruff and mypy as in CONTRIBUTING.

How to Get Help

• Open a GitHub issue with steps to reproduce and environment details.