Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

alt text

Build Status codecov DOI Codacy Badge Twitter

A system for collaborative ontology development process. Given a repository with an owl file, OnToology will survey it and produce diagrams, a complete documentation and validation based on common pitfalls. It also offers seamless publication of user ontologies with w3id using GitHub pages.

You can find a live version of OnToology online:

Team: Ahmad Alobaid, Daniel Garijo, Maria Poveda, Idafen Santa, Alba Fernandez Izquierdo, Oscar Corcho

License: Apache License v2 ( License

If you want to cite Ontoology in a scientific paper or technical report, you can use the following Bibtex citation or directly this text: Alobaid A, Garijo D, Poveda-Villalón M, Santana-Pérez I, Fernández-Izquierdo A, Corcho O (2019) Automating ontology engineering support activities with OnToology. Journal of Web Semantics 57:100472,


The development of OnToology has been supported by the Spanish national project Datos 4.0 (TIN2016-78011-C4-4-R)


Here is a list of tools being used by OnToology.

Documentation for users

If you are an ontology engineer willing to use OnToology, you can check our step by step documentation. You can also check our list of Frequently Asked Questions

Documentation for developers

We provide some documentation for developers who want to contribute to the development OnToology or for those who are interested in deploying OnToology locally or in their servers. Feel free to contact us if you are interested in contributing to the project.

Test workflow

There are two kinds of tests:

  1. Using mock. These kinds of tests use a list of stored requests expected from GitHub APIs. These are fast and do not need GitHub keys or setup.
  2. Using real GitHub repos. These kinds of tests uses GitHub APIs. These tests can take some time and need special keys to access relevant test repos. For this reason, these are not available for the public. However, they are executed automatically after each merge to the main branch.

Run Tests on Real GitHub Repo

This is only available for certain people

  1. Copy the keys into the folder ssh
  2. Create a file scripts/
  3. Write the following and fill the missing values (currently the private app is not added in the tests, so it can be left empty). (see secret setup section below).
  4. Run the tests on docker
sh scripts/

Note: If you made changes, you might need to rebuild the image docker-compose build

Secret Setup

export github_password=""
export github_email=""
export client_id_login=""
export client_id_public=""
export client_id_private=""
export client_secret_login=""
export client_secret_public=""
export client_secret_private=""
export test_user_token=""
export test_user_email=""
export github_username=""

Run Locally

  1. Setup (see Run Tests on Real GitHub Repo section here)
  2. Run the following: sh scripts/
  3. Go to and start using OnToology.


  1. Clone the repo.
  2. Set up the variables in OnToology/ (see above for the details).
  3. Create virtual env (optional).
  4. Install dependencies using pip (pip install -r requirements).
  5. Run the stiqueue server (with the ip and port).
  6. Run OnToology/