AgreementMakerLight (AML)

Installing AML

AML comes in a ready-to-run jar file, which requires no installation.

You can just download the latest release from the releases tab (, extract the zip file, and AML will be ready to run.

You do need Java installed in your machine. The latest AML release has been tested in Oracle Java 1.7, 1.8 and 1.9. We can not guarantee it will run in Open JDK version of Java.

Running AML in user interface mode

To run AML's user interface, you just have to execute the AgreementMakerLight.jar with no command line arguments. This can be done by double-clicking the file (it if has execution permissions) or by typing:

java -jar AgreementMakerLight.jar

Running AML in command line mode

To run AML in command line mode, you have to execute the AgreementMakerLight.jar with command line arguments:

java -jar AgreementMakerLight.jar OPTIONS

Where the OPTIONS are:

-s (--source) 'path_to_source_ontology'     Specifies the source ontology file (mandatory)
-t (--target) 'path_to_target_ontology'     Specifies the target ontology file (mandatory)
-i (--input) 'path_to_input_alignment'      Specifies the input alignment file (mandatory in repair mode; used as reference in match mode)
-o (--output) 'path_to_ouput_alignment'     Specifies the output alignment file (AML will not save the result without this)
-a (--auto)                                 Sets AML in automatic match mode (one of the three modes must be specified)
-m (--manual)                               Sets AML in manual match mode (you can configure it in the store/config.ini file)      
-r (--repair)                               Sets AML in repair alignment mode (requires input alignment to repair)

Building AML with Maven

Instead of downloading the latest AML release, you can use Maven to build it, after you clone the AML-Project repository. Use the following command:

mvn install

Note: We have found a few errors when compiling AML with Maven. We are working on fixing them, but please avoid this solution for the time being, and try downloading the latest AML release instead.

Copyright 2013-2019 LASIGE

AML includes software developed at LASIGE ( in collaboration with the ADVIS Lab ( and the Bioinformatics Unit of the IGC (

If you use AML, please cite the following publication:

D. Faria, C. Pesquita, E. Santos, M. Palmonari, I. Cruz, and F. Couto, The AgreementMakerLight ontology matching system, ODBASE 2013.