How to install plugins

The functionality of AiiDA can be extended through plugins. There are various types of functionality that can be extended, such as new data types, calculation plugins and much more. Multiple plugins can be bundled together and distributed in a plugin package. The AiiDA plugin registry gives an overview of public plugin packages.

Installing an AiiDA plugin package is done with pip. If the package is distributed via the Python Package Index (PyPI) you can install it as follows:

$ pip install aiida-plugin-name

A package can also be installed from the source code. For example, if the code is available through a Git repository:

$ git clone
$ cd aiida-diff
$ pip install .


Each time when you install a new plugin package you should make sure to run the following command to let AiiDA know about the new plugins that come with it:

$ reentry scan

If you forget to run this command, AiiDA will not be able to find the plugins. The reentry cache can also be updated from python when access to the commandline is not available (e.g. in Jupyter notebooks).

from reentry import manager


If your daemon was running when installing or updating a plugin package, make sure to restart it with the --reset flag for changes to take effect:

$ verdi daemon restart --reset

This needs to be done after the command reentry scan is called.

To verify which plugins are currently installed, use the command:

$ verdi plugin list

It will list the various categories of functionality that can be extended through plugins. To see which plugins are installed for any of these categories, pass the category name as an argument, e.g.:

$ verdi plugin list