Ontomesh
The semantic system of record for your enterprise. Derive a formal model of the systems you already run, govern how it changes, and prove where every answer came from. Built from your schema and your logs — without hand-crafting a single Turtle file.
Preview release. Public API surface is stabilising; expect occasional breaking changes until 1.0.
What's in the image
| Image | ghcr.io/synaptixs/ontomesh:3.10.2 (and :latest) |
| Size | ~316 MB compressed |
| Architectures | linux/amd64, linux/arm64 (Apple Silicon ready) |
| Base | python:3.12-slim |
| Runtime user | non-root ontomesh (uid 10001) |
| Process | single-process Flask via the ontoforge-wizard console script |
| Default port | 5051 (configurable via ONTOMESH_PORT) |
| Persistent data | /data (mount a volume here) |
| Healthcheck | GET /health every 30 s |
Run it
# Ephemeral run (resets on stop):
docker run --rm -p 5051:5051 ghcr.io/synaptixs/ontomesh:latest
# Persistent run (saved ontologies survive container restart):
docker volume create ontomesh-data
docker run -d --name ontomesh \
-p 5051:5051 \
-v ontomesh-data:/data \
-e ONTOMESH_DATA_DIR=/data \
ghcr.io/synaptixs/ontomesh:latest
Then open http://localhost:5051 in your browser.
Screenshots — a guided tour
A walkthrough from landing page to ontology-grounded reasoning search, in order.
1. Landing — the marketing entry point.
2. Model your domain — a guided, navy + lime-green Twilight wizard that walks you from a domain to a generated ontology in four phases — Define → Enrich → Build → After.
3. Run report — every run emits a branded HTML report: competency-question results, governance scorecard, semantic-loss analysis, and orphan-class checks.
4. Ask — pose a question — the read-only, ontology-grounded Ask console. Pick a flavor and provider (Ollama / OpenAI), set your sensitivity-tier ceiling, and optionally build an RDF subgraph for live SPARQL.
5. Ask — a cited, reasoned answer — the answer cites its sources, shows the exact read-only SQL that ran, materializes the result subgraph, and streams the full reasoning trace (plan → execute → relations → reason → synthesize).
6. Ask — live SPARQL over the result subgraph — interrogate exactly what
grounded the answer with a SPARQL SELECT against the materialized RDF triples.
The wizard ships three themes — Twilight (default), Mono, and Light — switchable from the “All steps” drawer.
What you get
| URL | What it serves |
|---|---|
/ |
Marketing landing — value prop + install snippet |
/wizard |
The 11-step modeling wizard (Domain → Entities → Events → Relationships → Log Discovery → CQs → Rules → Generate → Evolution Review → Compliance → Vector Retrieval) |
/projects |
Dashboard of every ontology you've saved — one-click resume |
/help |
Per-phase help pages explaining each step |
/health |
JSON liveness probe |
/api/events/stream |
Server-Sent Events feed (drift + metric updates) |
/api/ontologies |
REST endpoint for the saved-ontologies store |
/api/templates |
REST endpoint listing available starter templates |
Configuration (env vars)
| Variable | Default | What it does |
|---|---|---|
ONTOMESH_HOST |
0.0.0.0 |
Bind address |
ONTOMESH_PORT |
5051 |
Bind port |
ONTOMESH_DATA_DIR |
/data |
Where SQLite + saved ontologies + generated outputs live |
ONTOMESH_DB_URL |
(unset → SQLite at $ONTOMESH_DATA_DIR/ontologies.db) |
Set to postgresql://user:pass@host:5432/dbname to use Postgres instead |
What ships inside
| Pipeline phases | 8 build phases + 8 enrichment phases (log mining L4-L13, schema inference, multi-target generation) |
| Ontology | OWL 2 DL — owl:Restriction class expressions, defined classes, owl:hasKey from UNIQUE constraints, union domains |
| Instance data | --phase abox materialises individuals from your rows, with reified PROV-O chains and sensitivity-tier gating |
| Modelling depth | OWL-Time bitemporal (valid vs transaction time) · QUDT united quantities · reified n-ary participation |
| Validation | SHACL 1.1 shapes + materialised inference with prov:wasDerivedFrom lineage |
| Self-checking | OOPS!-style pitfall detection, structural metrics, in-process consistency (owlrl), and a CI regression ratchet |
| Reasoning | OWL-RL · SWRL · Datalog (Rulewerk) |
| Output formats | OWL/Turtle · SHACL · JSON-LD · SKOS · materialisation report |
| Wizard surfaces | 10 starter industries (telecom, healthcare, finance, manufacturing, retail, energy-utilities, government, insurance, logistics, pharmaceuticals) |
| Discovery | Drain3 templates · per-service HMMs · Granger / transfer-entropy gating · PMI co-occurrence |
| Database backends | SQLite (default) · PostgreSQL · MySQL · MSSQL · Oracle · DB2 |
| LLM adapters | Anthropic · OpenAI · Vertex AI · Ollama · OCI |
| Vector backends | FAISS · Chroma (scaffolded: Qdrant · pgvector) |
First-time experience
The first time you load the wizard with an empty session, a welcome modal offers ten starter industries. Pick one to populate the session with a real ontology you can edit, or "Start with a blank session" to build from scratch.
Persistent SQLite vs. Postgres
The image defaults to SQLite-on-disk. For multi-host or multi-replica deployments, set ONTOMESH_DB_URL to a Postgres connection string — the wizard switches transparently. Both backends share the same wire schema.
Source · documentation · deployment recipes
The full developer documentation, deployment guides (Compose / Fly.io / Render / Cloud Run), and source code live in the repository:
https://github.com/synaptixs/ontomesh
Specifically:
deploy/README.md— picking a deployment targetdocs/integrate.md— connecting to your own databasecompose.yml+deploy/Caddyfile— single-host TLS recipefly.toml·render.yaml·deploy/cloudrun.yaml— managed-runtime configs
Feedback
File a tester-feedback issue — the form has a short three-option dropdown (Bug · Friction · Idea · Docs), optional repro/expected sections, and auto-applies the tester-feedback label. Or message the team directly.
Looking for what changed when? See CHANGELOG.md.
Ontomesh v3.10.2 · Apache-2.0 · OWL 2 DL · instance data · self-checking output · Reasoning Search · gunicorn · Redis SSE · Prometheus · cosign-signed · OWL 2 · SHACL · PROV-O · SKOS · JSON-LD · 1000+ tests · Docker, Compose, Fly.io, Render, Cloud Run
Metadata
Release files for ontoforge 3.10.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ontoforge-3.10.2.tar.gz | 1.4 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ontoforge-3.10.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.5 MB
Release files / ontoforge-3.10.2.tar.gz
| Download URL | ontoforge-3.10.2.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6939211fad4ea1bf8fb7907898acd14cfed7684bc79887b7a15f193460d75bec
|
|
BLAKE2b-256 checksum How to use checksums |
32224a11ad7a1625d0360e26e7f73d8e38e8fcd735d419683e7079c8a1f2c094
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logRelease files / ontoforge-3.10.2-py3-none-any.whl
| Download URL | ontoforge-3.10.2-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b9b6f145e934aa08dc1a78adfebe02dd45f63899f83006edfe18cbbd59c3d30f
|
|
BLAKE2b-256 checksum How to use checksums |
15cb2fe6ac8f0e25dbf6c857423edc3d33449038df4dd30815c3012dee7da047
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logSecurity for ontoforge 3.10.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for ontoforge-3.10.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.