kadi 1.9.0

A generic and open source virtual research environment.

Kadi4Mat

Kadi4Mat, or Kadi for short, is a generic and open source virtual research environment. Originally developed in the context of materials science, Kadi4Mat can be used for the management of any type of research data within different research disciplines and use cases. For more information about the project, please see its website and documentation.

Installation

While the packaged code of Kadi4Mat can easily be installed as a Python package via pip, a complete installation requires a few additional dependencies and considerations. Please refer to the stable documentation for full installation instructions.

Development

Contributions to the code are always welcome. However, please consider creating an issue first, as described below, if you are planning to make larger changes. Please refer to the latest documentation for instructions on how to set up a development environment of Kadi4Mat as well as other useful information, such as how to set up a separate fork of the main repository.

In order to merge any contributions back into the main repository, please open a corresponding merge request. Typically, the source branch of the merge request would be a separate (feature) branch of your forked repository containing the changes to merge, while the target branch should correspond to the master branch of the main repository. Depending on the changes, please make sure to add appropriate tests, documentation, translations, etc. and also add a corresponding entry to the changelog in HISTORY.md, if necessary. Furthermore, you can add yourself as a contributor to AUTHORS.md.

Issues

For any issues regarding Kadi4Mat (bugs, suggestions, discussions, etc.) please use the issue tracker of this project. Make sure to add one or more fitting labels to each issue in order to keep them organized. Before creating a new issue, please also check whether a similar issue is already open. Note that creating or interacting with issues requires a GitLab account.

For bugs in particular, please use the provided Bug template when creating a new issue, which also adds the Bug label to the issue automatically. For security-related issues or concerns, please see SECURITY.md.