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

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.5
File Size Uploaded Provenance Actions
oxp_ontology-1.0.5.tar.gz 35.6 kB With provenance Details for oxp_ontology-1.0.5.tar.gz

Built distribution (wheel)

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

Total release size: 99.6 kB

Release files / oxp_ontology-1.0.5.tar.gz

Download URL oxp_ontology-1.0.5.tar.gz
Size 35.6 kB
Tags Source
SHA-256 checksum
How to use checksums
8d4f9df5404a1a30d6439fda2254afeeab5147554bb0bc7850473c1a608e14f7
BLAKE2b-256 checksum
How to use checksums
75798f496f39e9a1486b8eb467aab8e2338bbe981ba15a7b5f951f0c38539663
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 12, 2026.

Transparency log

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

Download URL oxp_ontology-1.0.5-py3-none-any.whl
Size 64.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
81b332e9ac7f6021f63269de7e325bcc2afb245b8949f59e50574d3852a529da
BLAKE2b-256 checksum
How to use checksums
a93c871eb17556dc433cc5fa2857e1e9c2930c92452d74d528f35093ce6bca5a
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 12, 2026.

Transparency log

Security for oxp-ontology 1.0.5

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.5.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 12, 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