Skip to main content

oxp-ontology

Multi-Agent System (MAS) Execution Ontology — RDF/OWL vocabulary and Python helpers for describing, validating, and querying multi-agent system telemetry as a knowledge graph.

Part of the Observe and eXplain Platform.

What's included

Five Turtle ontologies under a single mas: namespace:

Ontology Covers
mas Core schema: MAS, Agent, LLM, Tool, Processing, their execution instances, and the normalized State/Transition trajectory
metrics Metric/MetricResult definitions and observations
semantic Embedding layer linking trajectory nodes to vector embeddings
analysis Group-scoped analysis reports (consistency, anomaly, normal behaviour)
insight Catalog-templated insights rendered onto a knowledge-graph node

Plus SHACL shapes (mas-shapes.ttl, mas-shapes-custom.ttl) for validating knowledge-graph instances against the ontology.

Install

pip install oxp-ontology

Usage

Import the ontology in your own RDF

@prefix mas: <https://outshift-open.github.io/oxp-ontology/mas#> .
@prefix ex: <http://example.org/myproject#> .

ex:myAgent a mas:Agent ;
    mas:executes ex:myTask .

ex:myMAS a mas:MAS ;
    mas:hasAgent ex:myAgent .

Access bundled files and load graphs

from oxp_ontology import get_ontology_path, load_graph

# Valid names: mas, semantic, metrics, analysis, insight,
# mas-shapes, mas-shapes-custom
mas_path = get_ontology_path("mas")

g = load_graph("mas")

Validate and verify

from oxp_ontology import validate_bundled_ontologies, verify_kg_object

# Structural validation of the bundled TTL files
report = validate_bundled_ontologies()

# SHACL-based verification of a KG object against mas-shapes(-custom).ttl
verify_kg_object(my_kg_dict)

Query with SPARQL

PREFIX mas: <https://outshift-open.github.io/oxp-ontology/mas#>

SELECT ?agent ?task WHERE {
    ?agent a mas:Agent ;
           mas:executes ?task .
}

Documentation

Full ontology documentation (Widoco reference docs and WebVOWL visualizations for each component), versioning strategy, and the source repository are at:

https://outshift-open.github.io/observe-and-explain-platform/

License

Apache-2.0. The bundled ontology files declare dcterms:license <https://opensource.org/licenses/Apache-2.0> in their headers.

Metadata

Release files for oxp-ontology 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oxp-ontology 1.0.1
File Size Uploaded Provenance Actions
oxp_ontology-1.0.1.tar.gz 33.3 kB With provenance Details for oxp_ontology-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for oxp-ontology 1.0.1
File Interpreter ABI Platform Actions
oxp_ontology-1.0.1-py3-none-any.whl Python 3 none any Details for oxp_ontology-1.0.1-py3-none-any.whl

Total release size: 94.1 kB

Release files / oxp_ontology-1.0.1.tar.gz

Download URL oxp_ontology-1.0.1.tar.gz
Size 33.3 kB
Tags Source
SHA-256 checksum
How to use checksums
8a38a4430e1e467122d2b6078c1c7947e5a74f75a3c7033c57cd92ba4decad30
BLAKE2b-256 checksum
How to use checksums
99918417924447e804b7bb81aa6faced962e850890974b693d8b15e37bd3d20f
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 Oct 5, 2026.

Transparency log

Release files / oxp_ontology-1.0.1-py3-none-any.whl

Download URL oxp_ontology-1.0.1-py3-none-any.whl
Size 60.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d505e8336f61792aceca27293a76b3713d29ddab0ee8a9f892d6de6dac652692
BLAKE2b-256 checksum
How to use checksums
1c9d0518552a39febabe9cf6aab015112db7f58efac1bceec34f8aa97a9049a7
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 Oct 5, 2026.

Transparency log

Security for oxp-ontology 1.0.1

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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for oxp_ontology-1.0.1.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 Oct 5, 2026.

Transparency log

A 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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page