Welcome to itwinai’s documentation!
itwinai is a framework for advanced AI/ML workflows in Digital Twins (DTs).
This platform is intended to support general-purpose MLOps for Digital Twin use cases in the interTwin project.
Platform for machine learning workflows in digital twins
The goal of this platform is to provide ML researchers with an easy-to-use endpoint to manage general-purpose ML workflows, with limited engineering overhead, while providing state-of-the-art MLOps best practices.
The user can fully describe ML workflows for DT applications by providing a set of configuration files as input.
The itwinai platform instantiates ML workflows with the configurations provided by the DT developer.
The execution of ML workflows outputs a set of ML metrix, which are visualised by itwinai via MLFlow.
The trained ML model that performed best on the validation dataset is saved to the Models Registry for future predictions.
In itwinai platform, we focus mainly on the MLOps step, simulating or oversimplifying the rest (e.g., pre-processing, authentication, workflow execution).
How to read the docs
To effectively utilize the itwinai framework documentation, start by exploring the “Getting started with itwinai” section.
This section is crucial for understanding the basics, setting up the framework, including detailed instructions for
different types of installations such as User Installation either on HPC or on your laptop and Developer Installation.
For a deeper understanding of the framework’s core functionalities,
refer to the “Itwinai How It Works” section, which covers key concepts like Distributed Data Parallelism.
The “Integrated Use Cases” section provides practical examples and interTwin project use cases’ scenarios where itwinai
has been applied, offering valuable insights into real-world applications.
To further enhance your skills, explore the “Tutorials” section, which includes comprehensive
guides on Distributed ML training and ML workflow tutorials. Lastly, the “Python API Reference” section is an essential
resource for detailed information on the framework’s API, helping you to implement specific features and functions in your projects.
By following these sections systematically, you can maximize your understanding and effective use of the itwinai framework.
itwinai documentation also offers different versions, such as the ‘latest’, ‘stable’, ‘dev’, ‘v0.0.2-beta’, and ‘v0.0.1’.
The ‘latest’ version includes the most recent updates and features reflecting main branch developments,
while the ‘stable’ version tracks the most recent project release based on semantic tagging and is recommended for production
use due to its reliability (learn more).
The ‘dev’ version contains the latest development changes and is suitable for contributors and early testers,
reflecting dev branch.
The specific version numbers (like ‘v0.0.2-beta’ and ‘v0.0.1’) correspond to particular releases with their unique set of features and fixes.