Skip to content

osirisjson/osiris-producers

The OSIRIS JSON Producers

GitHub license Go Reference Security Rating

An OSIRIS JSON Producer is a lightweight, read-only program written in Go that runs on your workstation or server. It connects directly to supported infrastructure environments, discovers resources and relationships, normalizes vendor-specific data, redacts sensitive values, and generates a portable OSIRIS JSON document representing the infrastructure at a specific point in time.

The OSIRIS JSON producer for AWS

In this demo it's connecting to AWS account and generating an OSIRIS JSON document

The OSIRIS JSON Manifesto in practice

End-to-end infrastructure visibility should not depend on tribal knowledge, expensive consultancy, or closed and proprietary external platforms.

When you run an OSIRIS JSON Producer:

  • No AI platform, MCP server, or external agent is required.
  • No SaaS subscription or intermediary service is required.
  • The OSIRIS JSON producer runs within an environment you fully control.
  • Credentials and authentication material are excluded from the generated document.
  • Operational logs provide clear visibility into discovery, normalization, redaction, and emission.

The generated OSIRIS JSON document remains local unless you decide to move, integrate, or share it. You alone determine how it is used.

Read the OSIRIS JSON Manifesto


Architecture workflow

flowchart TD 
    subgraph VP ["Vendor / Platform"]
        A["Hyperscalers, Cloud & Hosting Providers"]
        B["On-Premises<br/>IT and OT"]
    end
    
    subgraph SP ["The OSIRIS JSON Specification"]
        S["The authoritative<br/>source of truth for the<br/>specification and core schema"]
    end
    
    subgraph PR ["The OSIRIS JSON Producers"]
        P["Discover, Normalize, Redact, Emit"]
        J["OSIRIS JSON Document<br/>Portable point-in-time infrastructure snapshot"]
    end
    
    subgraph VA ["The OSIRIS JSON Toolbox"]
        V["Validation toolbox<br/>Three-level validation"]
    end
    
    subgraph OC ["The OSIRIS JSON Consumers"]
        C["Consumers under development<br/>Read OSIRIS JSON documents"]
        AD["Architecture documentation reports"]
        AU["Audit reports"]
        DF["Snapshot diff view"]
        TP["Automatic topology<br/>generation and updates"]
    end
    
    subgraph UC ["Under Your Full Control"]
        U["One OSIRIS JSON file<br/>Multiple use cases"]
        M["CMDB / IPAM / DCIM workflows"]
        AI["AI platforms, agents<br/>and MCP servers"]
        X["Custom analytics<br/>and third-party tools"]
    end
    
    A -->|"Discovered by"| P
    B -->|"Discovered by"| P

    S -. "Defines the format" .-> J
    S -. "Guides implementation" .-> P

    P -->|"Generates"| J

    J -->|"Validated by"| V

    J -->|"Consumed by"| C
    C -->|"Generates"| AD
    C -->|"Generates"| AU
    C -->|"Generates"| DF
    C -->|"Generates"| TP

    J --> U
    U --> M
    U --> AI
    U --> X
    
    style VP fill:transparent,stroke:#555,stroke-width:1px,color:inherit
    style SP fill:transparent,stroke:#555,stroke-width:1px,color:inherit
    style PR fill:transparent,stroke:#4F7FE7,stroke-width:2px,color:inherit
    style VA fill:transparent,stroke:#555,stroke-width:1px,color:inherit
    style OC fill:transparent,stroke:#555,stroke-width:1px,color:inherit
    style UC fill:transparent,stroke:#555,stroke-width:1px,color:inherit
Loading

Available producers

OSIRIS JSON Producer Category Status
Amazon AWS Hyperscaler Available
Microsoft Azure Hyperscaler Available
Google Cloud Hyperscaler Under development
Cisco Network Available
Cloudflare Hyperscaler Planned
Proxmox VE Hypervisor Under development
HPE Aruba Central Network Under development

For the complete roadmap, visit osirisjson.org/en/commitments/roadmap.

Installation

See the official guidelines available on docs.osirisjson.org/osiris-producers/installation

Documentation and contribution

About

Discover infrastructure resources across hyperscalers, cloud and hosting providers, and on-premises IT/OT environments. Generate private, vendor-neutral OSIRIS JSON snapshots for documentation, audits, diffs, integrations, and context-optimized projections for controlled AI, agent, and MCP workflows.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Contributors