Skip to main content

INCEpTALYTICS is a package for analysing INCEpTION annotation projects.

Project description



An easy-to-use API for analyzing INCEpTION annotation projects.

  • We parse an XMI export of an Inception annotation project and provide easy access to (most) of the underlying data including annotators, source files, etc.
  • We provide recipes for computing project statistics, confusion matrices, inter-annotator-agreement, or plotting progress reports.


INCEpTALYTICS is on PyPi. To install it run:

pip install inceptalytics

Basic Usage

from inceptalytics import Project

file = "data/"

# load project
project = Project.from_zipped_xmi(file)

# print all annotator names
for annotator in project.annotators:

# create a view 
pos_type = "de.tudarmstadt.ukp.dkpro.core.api.lexmorph.type.pos.POS"

view =
        annotation=project.feature_path(pos_type, "coarseValue"), 

print('# pos annotations in view:', len(view.annotations))

print('IAA Krippendorff: ', view.iaa())


We also provide a basic Streamlit web application as a starting point for a dashboard that fits your needs.

To run the dashboard, you will have to install some additional dependencies.

pip install -r examples/streamlit_requirements.txt

Afterwards, you can run the dashboard.

streamlit run examples/

The application should be available in your browser under http://localhost:8501. The URL is also printed on the shell.

Screenshot of dashboard


Version 0.1.0

  • Project is now on PyPi.
  • Projects can now be loaded using the INCEpTION's Remote API using Project.from_remote.
  • Removed plotting functionality from INCEpTALYTICS and moved it to the dashboard under example.

Version 0.1.1

  • Added sanity checks and input normalisation to Project.from_remote.
  • Updated Project.from_remote to be compatible with the latest version of pycaprio.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

inceptalytics-0.1.1.tar.gz (10.5 kB view hashes)

Uploaded Source

Built Distribution

inceptalytics-0.1.1-py3-none-any.whl (10.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page