Request help or report a bug

Let us know if you encounter a problem installing or running BornAgain, or if you have a question about BornAgain models or numerics.

You may contact us in private by email, or in public by submitting an issue to our issue tracker.

Use the issue tracker to:

  • report a bug;
  • request help with installing or running BornAgain;
  • propose a new feature;
  • ask a question about the BornAgain API or model implementations.

Over time, public discussions and resolved issues form a knowledge base that anyone can read and search.

A quick look at the troubleshooting guide and existing reports may already provide an answer.

External users must register for Jugit access on first login.

What to include

Include enough information to reproduce and diagnose the problem:

  • operating system and processor architecture;
  • Python version and installation method (pip, uv, conda, or Homebrew);
  • BornAgain version, if it can be imported;
  • a minimal script or the exact commands that reproduce the problem;
  • the complete terminal output or traceback as text.

To print the installed version and package location, run:

python -c "import bornagain as ba; print(ba.version_str); print(ba.__file__)"