This release is a pre-release and may not be stable for production use.
Ontomesh
The ontology mesh for GraphRAG. Mine ontologies from your logs, validate with SHACL, ship a hybrid retriever — 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.7.0 (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 ontomesh-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.
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) |
| Validation | SHACL 1.1 shapes + materialised inference with prov:wasDerivedFrom lineage |
| 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.7.0 · Apache-2.0 · gunicorn · Redis SSE · Prometheus · cosign-signed · OWL 2 · SHACL · PROV-O · SKOS · JSON-LD · 297+ tests · Docker, Compose, Fly.io, Render, Cloud Run
1 maintainer
Metadata
1 maintainer
Release files for ontomesh 3.7.1.dev0
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 | |
|---|---|---|---|---|
| ontomesh-3.7.1.dev0.tar.gz | 1.3 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ontomesh-3.7.1.dev0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.3 MB
Release files / ontomesh-3.7.1.dev0.tar.gz
| Download URL | ontomesh-3.7.1.dev0.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dbbe2b61f2c16c40cfa8856cde52edfc1891002c4f54f2341ff322e8c4070f59
|
|
BLAKE2b-256 checksum How to use checksums |
a94572812bb2796a28ffb14f4c7249ebff3b3a299d0e92e323ccc24b78d859b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 5, 2026.
Transparency logRelease files / ontomesh-3.7.1.dev0-py3-none-any.whl
| Download URL | ontomesh-3.7.1.dev0-py3-none-any.whl |
|---|---|
| Size | 1.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f86fdc6477253b91ae7e9f541aa3a454e77f1eec699a16148440b107039535ff
|
|
BLAKE2b-256 checksum How to use checksums |
e68fe3a9d9b29845112db45134fa659662cdfc5be6e63af3ee96e1ae9c4eba6d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 5, 2026.
Transparency logSecurity for ontomesh 3.7.1.dev0
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 ontomesh-3.7.1.dev0.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 Jun 5, 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.
