itwinai 0.4.2

itwinai is a Python toolkit designed to help scientists and researchers streamline AI and machine learning workflows, specifically for digital twin applications. It provides easy-to-use tools for distributed training, hyper-parameter optimization on HPC systems, and integrated ML logging, reducing engineering overhead and accelerating research. Developed primarily by CERN, in collaboration with Forschungszentrum Jülich (FZJ), itwinai supports modular and reusable ML workflows, with the flexibility to be extended through third-party plugins, empowering AI-driven scientific research in digital twins.

See the latest version of our docs here.

Installation

For instructions on how to install itwinai, please refer to the user installation guide or the developer installation guide, depending on whether you are a user or developer

For information about how to use containers or how to test with pytest, you can look at the following documents:

• Working with containers
• Testing with pytest

How to contribute

Want to help improve itwinai? Here are a few good ways to get involved:

• Report a bug / request a feature: open a GitHub issue.
• Contribute code or docs: fork the repository and submit a pull request.
• Ask questions or float ideas: start a GitHub discussion or join us on Discord.

Citation

If you use itwinai in your research, please cite:

Bunino et al., (2026). itwinai: A Python Toolkit for Scalable Scientific Machine Learning on HPC Systems. Journal of Open Source Software, 11(117), 9409. https://doi.org/10.21105/joss.09409

BibTeX:

@article{Bunino2026,
  doi = {10.21105/joss.09409},
  url = {https://doi.org/10.21105/joss.09409},
  year = {2026},
  publisher = {The Open Journal},
  volume = {11},
  number = {117},
  pages = {9409},
  author = {Bunino, Matteo and Sæther, Jarl and Eickhoff, Linus and Lappe, Anna and Tsolaki, Kalliopi and
            Verder, Killian and Mutegeki, Henry and Machacek, Roman and Girone, Maria and Krochak, Oleksandr and
            Rüttgers, Mario and Sarma, Rakesh and Lintermann, Andreas},
  title = {itwinai: A Python Toolkit for Scalable Scientific Machine Learning on HPC Systems},
  journal = {Journal of Open Source Software}
}