mingrammer/diagrams

これは何？

主な機能

• 01gitでバージョン管理できるPythonコードとしてアーキテクチャ図を定義できます。
• 02AWS、Azure、GCP、Kubernetes、Alibaba Cloud、Oracle Cloudなどのアイコンセットを収録しています。
• 03オンプレミス、SaaS、プログラミング、C4のノードタイプに対応しています。
• 04Graphvizを使って図を生成します。
• 05ブラウザー上で動作するオンラインプレイグラウンドを利用できます。

ユースケース

• 実装前に新しいクラウドシステムのアーキテクチャをプロトタイピングする。
• 既存のクラウド環境やKubernetesのデプロイ構成を、コードと一緒に管理する図としてドキュメント化する。
• ドキュメント生成パイプラインでアーキテクチャ図を作成する。

クイックスタート

1. 1

   Graphvizをインストール（macOSではHomebrewを使用）

   brew install graphviz
2. 2

   pipでdiagramsパッケージをインストール

   pip install diagrams

使う前に知っておきたいこと

• !図を描画するには、Graphvizを別途インストールしておく必要があります。
• !Python 3.9以降が必要です。
• !クラウドリソースの操作やTerraform、CloudFormationコードの生成はできません。図の描画のみを行います。

トピック

よくある質問

diagrams とは？

Diagram as Code：Pythonで記述してクラウドやシステムのアーキテクチャ図を作成。AWS、Azure、GCP、Kubernetesなどのアイコンを利用できます。 Diagramsは、クラウドシステムのアーキテクチャ図をコードとして描くためのPythonライブラリです。デザインツールで図形をドラッグする代わりに、Pythonスクリプトでノードとその接続を記述すると、Graphvizで図が生成されます。図が通常のコードとして扱えるため、任意のバージョン管理システムで管理でき、表現するインフラと一緒に変更できます。

diagrams は無料で使えますか？ライセンスは？

diagrams は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

diagrams は今もメンテナンスされていますか？

活発にメンテナンス中。diagrams の最終コミットは 2026年10月17日 です。

diagrams は何に使えますか？

実装前に新しいクラウドシステムのアーキテクチャをプロトタイピングする。 既存のクラウド環境やKubernetesのデプロイ構成を、コードと一緒に管理する図としてドキュメント化する。 ドキュメント生成パイプラインでアーキテクチャ図を作成する。

diagrams のインストール方法は？

Graphvizをインストール（macOSではHomebrewを使用）: brew install graphviz pipでdiagramsパッケージをインストール: pip install diagrams

diagrams はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/mingrammer/diagrams