Skip to content

Ontobot: applying KGCL from GitHub issues

Many ontologies are developed on GitHub: change requests arrive as issues, and changes are made through pull requests (PRs). Turning each request into an edit by hand is slow, and it depends on an ontology editor having time to do it. Ontobot (the ontobot-change-agent) automates the middle of that process. It reads KGCL commands from an issue and opens a PR that makes the change. A curator still reviews and approves every PR.

Ontobot runs as a GitHub Action, so an ontology repository can add it without any other infrastructure. Repositories that use it include GO, Mondo, Uberon, ENVO, the Cell Ontology, and PATO; see the Ontobot README for the current list.

How it works

Ontobot watches new and edited issues for the phrase Hey ontobot!, apply: (the ! is optional), followed by a bulleted list of KGCL commands:

Hey ontobot!, apply:

- create exact synonym 'cortical visual impairment' for MONDO:0001385
- create related synonym 'CVI' for MONDO:0001385

Four steps: a user opens an issue with KGCL commands, Ontobot responds, Ontobot opens a pull request, and a curator approves it

A change request handled by Ontobot. (1) A user opens an issue in the ontology repository containing Hey ontobot!, apply: and a KGCL command, here adding an exact synonym to a Mondo term. (2) Ontobot sees the instruction and responds. (3) Ontobot opens a PR that makes the change in the ontology source file, and curators are assigned to review it. (4) Once a curator approves, the PR is merged and the change appears in the next release. Reproduced from Hegde et al. 2025, Fig. 4 (CC BY 4.0).

Close-up: the issue and the pull request

An issue asking Ontobot to add a synonym to a Mondo term:

A GitHub issue containing "Hey ontobot!, apply:" and a KGCL command

The change in the PR that Ontobot opens in response:

The ontology file change in the pull request generated by Ontobot

If a maintainer is satisfied with the change, they approve the PR and it is merged into the ontology source file. Otherwise they can edit it or close it, like any other PR.

Setting it up

The Ontobot manual covers installation and provides a workflow template (.github/workflows/ontobot.yaml) to customize and add to the repository that holds the ontology source file.

Curators who would rather not write KGCL at all can request changes through BioPortal, which writes the KGCL and opens the issue for them.