Skip to content
Cytomine Inter-Observer Reliability Study Module
JavaScript Groovy HTML CSS Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

When using our software, we kindly ask you to cite our website url and related publications in all your work (publications, studies, oral presentations,...). In particular, we recommend to cite (Marée et al., Bioinformatics 2016) paper, and to use our logo when appropriate. See our license files for additional details.


Cytomine IRIS, the Inter-observer Reliability Study module, is a web-based rich internet application for blinded assessment of histopathological slide annotations.

Getting Started

Once IRIS is installed, visit the Getting Started with IRIS User Guide on the wiki pages to get a short introduction. You are also welcome to watch the short getting-started tutorial on YouTube. Getting Started Tutorial


Please visit our wiki pages for detailed documentation on how to install, administer and use Cytomine-IRIS.


For a more detailed guide on how to set up a production IRIS instance, please see the Installation Guide on our wiki pages.


- Java 7 or higher
- Apache Tomcat 7.0.x or higher (Servlet compatibility 3.0)
- Grails 2.3.11 (just for compilation)


$ cd ~
$ git clone
$ cd Cytomine-IRIS


$ cd src/java
$ ls -l

There should be 3 config files, one for common config, and one for each environment production and development, which mainly contains the server configuration and mail server settings. Make a directory for externalized config in the home of the user which will run the tomcat server and copy the groovy files

$ mkdir ~/.grails 
$ cp iris-* ~/.grails 
$ cd ~/.grails

Now alter the configurations according to your deployment environment, server name, port, Cytomine core server connection etc. Find detailed instructions here.

Compile IRIS

$ cd ~/Cytomine-IRIS
$ grails war

Deploy to Apache Tomcat

$ mv target/iris-<version>.war target/iris.war  # rename for auto-deploy with context in tomcat
$ cp target/iris.war $CATALINA_HOME/webapps/

Finally run the tomcat instance and the application will be available with your custom configuration from ~/.grails/iris*-config.groovy. The database (H2) is created automatically and so are the server log files.

Access the frontend

Browse to to view the application front end.


As of version 2.5, IRIS is restricted to assign one single label per user only. This essentially means that you should not use IRIS for projects, where users are allowed to assign labels using the Cytomine core web interface as well. This is because once a user uses IRIS to assign a label to an annotation, all previously assigned labels are removed!

Bug Reports

Please file any Cytomine-IRIS related bugs or issues here in this Github issue tracker. We will do our best to fix them as soon as possible.

You can’t perform that action at this time.