Unified Python interface for multiple graph databases
The graph database landscape is fragmented, with each triple store having its own APIs, deployment methods, and operational quirks. Developers and researchers working with RDF data often need to:
- Switch between different triple stores for performance comparisons
- Migrate data from one system to another
- Test the same queries across multiple backends
- Deploy applications that work with various graph databases
This leads to:
- ❌ Duplicated effort writing database-specific code
- ❌ Vendor lock-in making migrations difficult
- ❌ Inconsistent interfaces slowing development
- ❌ Manual deployment processes for each database
pyomnigraph solves this by providing:
- ✅ Unified API - Same Python interface for all supported databases
- ✅ Standardized deployment - Consistent Docker-based setup
- ✅ Easy switching - Change backends with a single parameter
- ✅ Comparative testing - Run identical operations across multiple stores
- ✅ Simplified management - Start, stop, load data with simple commands
| Database | Status | Notes |
|---|---|---|
| Apache Jena | 🟢 Working | Robust, standards compliant |
| Blazegraph | 🟢 Working | High performance, easy setup |
| Oxigraph | 🟢 Working | Rust-based, embedded, fast |
| QLever | 🟢 Working | Extremely fast queries |
| GraphDB | 🛑 Disabled | License required (free version available) |
| MillenniumDB | 🛑 Disabled | Import-first workflow, Property Graph + RDF |
| Virtuoso | 🛑 Disabled | Permissions issue (#30) |
| Stardog | 🛑 Planned | License required |
Whether you're building a semantic web application, conducting research, or evaluating different triple stores, pyomnigraph eliminates the complexity of working with multiple graph database systems.
omnigraph omnigraph --list --include-inactive --doc-format github| Active | Name | Container Name | Wikidata | Image | Port | Test Port | Dataset | User |
|---|---|---|---|---|---|---|---|---|
| 🟢️ | blazegraph | blazegraph-omnigraph | Q20127748 | lyrasis/blazegraph:2.1.5 | 9898 | 7898 | kb | |
| 🟢️ | jena | jena-omnigraph | Q109376461 | stain/jena-fuseki:latest | 3030 | 7030 | ds | admin |
| 🟢️ | oxigraph | oxigraph-omnigraph | Q118980507 | oxigraph/oxigraph:latest | 7878 | 7378 | default | |
| 🟢️ | qlever | qlever-omnigraph | Q111016295 | adfreiburg/qlever:latest | 7019 | 7819 | olympics | |
| 🛑 | graphdb | graphdb-omnigraph | Q58425577 | ontotext/graphdb:11.2.0 | 7200 | 7700 | repo1 | |
| 🛑 | millenniumdb | millenniumdb-omnigraph | Q118954995 | imfd/millenniumdb | 1234 | 1734 | default | |
| 🛑 | stardog | stardog-omnigraph | Q91147741 | stardog/stardog:latest | 5820 | 5320 | mydb | admin |
| 🛑 | virtuoso | virtuoso-omnigraph | Q7935239 | openlink/virtuoso-opensource-7:latest | 8890 | 8390 | KB | dba |
# Start specific servers
omnigraph -s jena --cmd start
# Restart sequence - stop remove and start
omnigraph -s jena --cmd stop rm start
# Start all configured servers
omnigraph -s all --cmd start
# Check server status
omnigraph -s blazegraph --cmd status
# Open web ui
omnigraph -s jena --cmd webui# Load datasets
omnigraph -s blazegraph --cmd load
# Get triple count
omnigraph -s blazegraph --cmd count
# Use test environment
omnigraph --test -s blazegraph --cmd start loadomnigraph -h
usage: omnigraph [-h] [-a] [-d] [-ds DATASETS [DATASETS ...]] [-dc DATASETS_CONFIG] [-f] [-r {turtle,rdf-xml,n3,json-ld}] [-q] [-V] [--apache APACHE]
[-c CONFIG] [--cmd CMD [CMD ...]] [-df DOC_FORMAT] [-l] [--test] [-s SERVERS [SERVERS ...]] [-v]
Unified Python interface for multiple graph databases
options:
-h, --help show this help message and exit
-a, --about show about info [default: False]
-d, --debug show debug info [default: False]
-ds DATASETS [DATASETS ...], --datasets DATASETS [DATASETS ...]
datasets to work with - all is an alias for all datasets [default: ['wikidata_triplestores']]
-dc DATASETS_CONFIG, --datasets-config DATASETS_CONFIG
Path to datasets configuration YAML file [default: /Users/wf/Library/Python/3.12/lib/python/site-
packages/omnigraph/resources/examples/datasets.yaml]
-f, --force force actions that would modify existing data [default: False]
-r {turtle,rdf-xml,n3,json-ld}, --rdf_format {turtle,rdf-xml,n3,json-ld}
RDF format to use [default: turtle]
-q, --quiet avoid any output [default: False]
-V, --version show program's version number and exit
--apache APACHE create apache configuration file for the given server(s)
-c CONFIG, --config CONFIG
Path to server configuration YAML file [default: /Users/wf/Library/Python/3.12/lib/python/site-
packages/omnigraph/resources/examples/servers.yaml]
--cmd CMD [CMD ...] commands to execute on servers: bash, clear, count, info, load, logs, needed, rm, start, status, stop, webui
-df DOC_FORMAT, --doc-format DOC_FORMAT
The document format to use [default: plain]
-l, --list-servers List available servers [default: False]
--test use test environment [default: False]
-s SERVERS [SERVERS ...], --servers SERVERS [SERVERS ...]
servers to work with - 'all' selects all configured servers [default: ['blazegraph']]
-v, --verbose show verbose output [default: False]rdfdump -h
usage: rdfdump [-h] [-a] [-d] [-ds DATASETS [DATASETS ...]] [-dc DATASETS_CONFIG] [-f] [-r {turtle,rdf-xml,n3,json-ld}] [-q] [-V] [--limit LIMIT] [-l]
[--count] [--dump] [-4o] [--max-count MAX_COUNT] [--no-progress] [--output-path OUTPUT_PATH] [--tryit]
Unified Python interface for multiple graph databases
options:
-h, --help show this help message and exit
-a, --about show about info [default: False]
-d, --debug show debug info [default: False]
-ds DATASETS [DATASETS ...], --datasets DATASETS [DATASETS ...]
datasets to work with - all is an alias for all datasets [default: ['wikidata_triplestores']]
-dc DATASETS_CONFIG, --datasets-config DATASETS_CONFIG
Path to datasets configuration YAML file [default: /Users/wf/Library/Python/3.12/lib/python/site-
packages/omnigraph/resources/examples/datasets.yaml]
-f, --force force actions that would modify existing data [default: False]
-r {turtle,rdf-xml,n3,json-ld}, --rdf_format {turtle,rdf-xml,n3,json-ld}
RDF format to use [default: turtle]
-q, --quiet avoid any output [default: False]
-V, --version show program's version number and exit
--limit LIMIT Number of triples per request [default: 10000]
-l, --list List available datasets [default: False]
--count List available datasets with triple counts[default: False]
--dump perform the dump [default: False]
-4o, --for-omnigraph store dump at default omnigraph location [default: False]
--max-count MAX_COUNT
Maximum number of solutions/triples to download (uses dataset expected_solutions if not specified)
--no-progress Disable progress bar
--output-path OUTPUT_PATH
Path for dump files
--tryit open the try it! URL [default: False]