OSIRIS JSON

Open Standard for Infrastructure Resource Interchange Schema

Vendor-neutral JSON format for describing infrastructure resources and their topological relationships across heterogeneous IT and OT environments.

rocket_launch Get Started
Environments
IT + OT
OT: initial support
Version
1.0.0
Stable
Specification license
CC-BY-4.0
Open Source
crisis_alert

The challenge

Modern infrastructure spans multiple stacks and providers: hyperscalers (AWS, Azure, GCP etc.), public clouds providers, on-prem datacenters and complex OT environments integration.

While some platforms export inventories (often as JSON), the representations are inconsistent across vendors even for equivalent concepts like identity, properties, and relationships.

warning
Accurate topology documentation is expensive and fragile. Teams rely on partial, inaccurate documentation and hand-drawn diagrams. Critical context lives in people's heads.
verified

The solution

OSIRIS defines a vendor-neutral JSON schema for describing infrastructure resources and topological relationships across heterogeneous environments.

It normalizes exports from hyperscalers and cloud providers, on-prem datacenters (compute, storage, network), and supports OT inclusion where applicable (initial v1.0 scope).

check_circle
Cross-platform visibility and portable consumption by tools (diagramming, inventory, audit) without requiring each consumer to implement vendor-specific parsers.

What you get

Six core capabilities that make OSIRIS an open standard for infrastructure resource and topology interchange.

schema

Unified design

Built for heterogeneous IT environments, with a clear extension path for OT and other domains as adoption grows.

hub

Explicit relationships

First-class representation of connections, dependencies, containment, and other topology relationships.

account_tree

Flexible grouping

Support for logical and physical grouping that reflects real organizational and architectural structures without forcing a single taxonomy.

dns

Provider attribution

Resources preserve traceability to their source system/provider while using a standardized, vendor-neutral representation.

extension

Designed for extensibility

A defined mechanism for vendor-specific properties and custom resource types without breaking compatibility.

verified_user

Three-Level validation

Structural (schema), semantic and domain validation improving consistency and data quality when validation tooling is applied.

Design principles

OSIRIS is a static snapshot interchange format. It captures what exists and how it relates at a point in time. It was not designed as a real-time monitoring system, a deployment tool, or an Infrastructure-as-Code engine.

block What OSIRIS is NOT

close
Monitoring/Telemetry
Use Prometheus, Grafana, Zabbix, OpenTelemetry.
close
Observability platforms
Use Cilium, Grafana Tempo/Loki etc.
close
Infrastructure as Code
Use Terraform, Pulumi, TOSCA.
close
Configuration management
Use Ansible, Puppet, Chef, Salt.

check_circle What OSIRIS IS

Optimized for scenarios where documentation and topology must be exchanged between systems and teams.

photo_camera
Reliable, flexible infrastructure snapshots
Capture “what exists” and “how it relates” at a point in time.
description
Documentation-ready outputs
Enable consistent inventories, technical summaries and system context.
flowsheet
Diagram-friendly topology
Provide normalized relationships for automated visualization and diagram generation.
sync_alt
Feeding CMDB / IPAM / DCIM workflows
Export normalized data into systems of record and asset management tools.
security
Audit support
Assist evidence collection and traceability by standardizing structure and relationships.

Get hands-on with OSIRIS

Explore a Microsoft Azure and AWS OSIRIS topology snapshot with relationships, providers and groupings captured in one portable JSON document.

Download the examples

Get involved in the community

forum

GitHub Discussions

Ask questions, share ideas, and help shape the specification

Get involved

GitHub Repository

Contribute code, report issues, and submit pull requests

View

Ways to contribute

code

Code

Build producers/parsers for hyperscalers, cloud platforms and on-prem IT/OT systems.

description

Documentation

Improve guides, write tutorials and real-world use cases to help others adopt OSIRIS.

science

Testing

Validate the spec and schema with real infrastructure topologies and edge cases.

lightbulb

Feedback

Report issues, suggest improvements, or propose extensions and new features.

build

Tooling

Create SDKs, CLI tools, validators, exporters and documentation/diagramming tools.

share

Spread the Word

Write posts, give talks, record demos and share OSIRIS with your network.

design_services

Design & templates

Design high quality diagram templates, graphic layouts for docs and website, icons, sample datasets and reusable assets for the community.

Roadmap

OSIRIS is community-driven

OSIRIS was born from real-world problems and continues to grow through feedback, new ideas and practical contributions. If you have suggestions or want to help, jump in your input helps shape both the roadmap and the standard.

route View the roadmap

Support OSIRIS

Help us build an open standard for infrastructure documentation and topology exchange. Funding supports ongoing maintenance, tooling, and long-term sustainability.

rocket_launch

Accelerate Development

Fund core features, parsers, and tooling that benefit the entire community.

school

Better Documentation

Support comprehensive guides, tutorials, and examples for all skill levels.

groups

Grow the Ecosystem

Enable community events, integrations, and long-term standardization efforts.

Read more star Star the project on GitHub