Omnipath Secondary Adapter

About OmniPath

Omnipath is a database of molecular biology prior knowledge developed in Saez Lab and Korcsmaros Lab. It combines data from more than 100 resources and contains:

• protein-protein and gene regulatory interactions
• Enzyme and Post-Translational-Modifications(PTM) relationships
• Protein complexes
• Protein annotations
• intercellular communication.

Omnipath database stores the information in five different tables containing the aforementioned data.

• Networks
• Enzyme-PTM
• Complexes
• Annotations
• Intercell

#> [!WARNING] #> This BioCypher adapter relies on the Ontoweaver library that works with Python 3.12. Ensure the #Python version is 3.12 in your virtual environment.

About this adapter

The main goal of this adapter is to enable users to retrieve data from the Omnipath database and use that information to generate a knowledge graph. For achieving this goal, we are going use BioCypher and OntoWeaver.

• BioCypher:it is a framework for building biomedical knowledge graphs by integrating heterogeneous data into a structured, ontology-aligned graph representation.

• OntoWeaver: it is a visual and declarative ontology-based tool for designing and managing data integration systems, enabling intuitive schema mapping and semantic consistency. OntoWeaver has been built built on top of Biocypher.

Prerequisites

• Python 3
• Poetry [recommended]: Python packaging and dependency manager.
  • Install Poetry
• git: version control manager
  • Install git

Prerequisite	Version	Verify installation	How to install?
Python 3	>=3.12	$ python --version	link
Poetry	1.8	$ poetry about	link
git	>= 2.0	$ git --version	link
Neo4j desktop	2025.04.0	$ neo4j --version	link

Usage

1. Clone this repository and change to the directory:

git clone https://github.com/biocypher/omnipath-secondary-adapter
cd omnipath-secondary-adapter

2. Install all the dependencies (pre-configured in the pyproject.toml file):

poetry lock
poetry install --no-root

3. This current implementation generates Neo4j scripts for each table in the Omnipath database

Omnipath table	Script parameter	Neo4j script generation
Networks	-net or --networks	✅ Done
Enzyme-PTM	-enz or --enzyme-PTM	✅ Done
Complexes	-co or --complexes	❌ TO DO
Annotations	-an or --annotations	❌ TO DO
Intercell	-inter or --intercell	🛠️ In progress

We have built a ready-to-use script that downloads the resources from Omnipath, and generate the scripts to export a Neo4j graph.

Networks

poetry run python weave_knowledge_graph.py -net download

Enzyme-PTM

poetry run python weave_knowledge_graph.py -enz download

4. Once the script has processed the data, you can verify a folder has been generated in biocypher-out. It contains the following:

• neo4j-admin-import-call.sh
• CSV files:
  • *-header.csv: indicate the node/edge properties fields
  • *-part000.csv, *-part001.csv,...: store nodes/edges data based on the structure indicated in the *-header.csv files.

5. Populate the neo4j database, adapt the script path:

sudo neo4j stop
sudo bash biocypher-out/20250430155445/neo4j-admin-import-call.sh
sudo neo4j start

6. Open the Neo4j platform on http://localhost:7474
7. At the end, you have you Knowledge Graph! 🎉 Congratulations!