Repository files navigation

Diagram as Code.

Diagrams lets you draw the cloud system architecturein Python code. It was born forprototyping a new system architecture design without any design tools. You can also describe or visualize the existing system architecture as well. Diagrams currently supports main major providers including:AWS,Azure,GCP,Kubernetes,Alibaba Cloud,Oracle Cloud etc... It also supportsOn-Premises nodes,SaaS and majorProgramming frameworks and languages.

Diagram as Code also allows you totrack the architecture diagram changes in anyversion control system.

NOTE: It does not control any actual cloud resources nor does it generate cloud formation or terraform code. It is just for drawing the cloud system architecture diagrams.

It requiresPython 3.9 or higher, check your Python version first.

It usesGraphviz to render the diagram, so you need toinstall Graphviz to usediagrams. After installing graphviz (or already have it), install thediagrams.

macOS users can download the Graphviz viabrew install graphviz if you're usingHomebrew.

# using pip (pip3)$ pip install diagrams# using pipenv$ pipenv install diagrams# using poetry$ poetry add diagrams

You can start withquick start. Check outguides for more details, and you can find all available nodes list inhere.

Event Processing	Stateful Architecture	Advanced Web Service

You can find all the examples on theexamples page.

To contribute to diagram, check outcontribution guidelines.

Let me know if you are using diagrams! I'll add you in showcase page. (I'm working on it!) :)

Apache Airflow is the most popular data workflow Orchestrator. Airflow uses Diagrams to generate architecture diagrams in their documentation.

Cloudiscovery helps you to analyze resources in your cloud (AWS/GCP/Azure/Alibaba/IBM) account. It allows you to create a diagram of analyzed cloud resource map based on this Diagrams library, so you can draw your existing cloud infrastructure with Cloudiscovery.

Airflow Diagrams is an Airflow plugin that aims to easily visualise your Airflow DAGs on service level from providers like AWS, GCP, Azure, etc. via diagrams.

KubeDiagrams is a tool to generate Kubernetes architecture diagrams from Kubernetes manifest files, kustomization files, Helm charts, and actual cluster state.KubeDiagrams supports all Kubernetes built-in resources, any custom resources, and label-based resource clustering.

• If you are familiar with Go, you can usego-diagrams as well.

MIT