Skip to main content

Create infrastructure diagrams from configuration files (YAML and JSON) by using Graphviz

Project description


infrastructure-diagrams is a python package that allows creating infrastructure diagrams/graphs from configuration files (YAML and JSON). The package utilizes Graphviz <>__ to generate the diagrams. The functionality is exposed in the command line by the Unix command file.

Note: Some features are currently undocumented.


The package requires python >= 3.6. It has only been tested on Linux as the intended use was for automatically generating diagrams in a CI.


The current stable version of infrastructure-daigrams is available on pypi and can be installed by running pip install infrastructure-diagrams.

Other sources:


.. code:: bash

$ infrastructure-diagrams
usage: infrastructure-diagrams [-h] [-d DISPLAY] [-o OUTPUT] [-r RENDERER] file

positional arguments:
  file                  path to diagram file

optional arguments:
  -h, --help            show this help message and exit
  -d DISPLAY, --display DISPLAY
                        display the diagram after rendering
  -o OUTPUT, --output OUTPUT
                        output path for the diagram, including filetype (.svg, .png, etc.)
  -r RENDERER, --renderer RENDERER
                        output renderer used for rendering (cairo, gd, etc.)

Example: $ infrastructure-diagrams -o example.png examples/example.yaml

Configuration files

The configuration files extend the Graphviz Node, Edge and Graph Attributes <>__, meaning you can customize the diagram / graph as needed.


  • example.yaml |Output of example.yaml|

  • misc.yaml |Output of misc.yaml|

  • iot.yaml |Output of iot.yaml|

Example diagram configuration files can be found under the examples/ <>__ directory.

.. |Output of example.yaml| image:: .. |Output of misc.yaml| image:: .. |Output of iot.yaml| image::

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

infrastructure-diagrams-0.0.6.tar.gz (8.4 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page