PlantUML에서 일반 텍스트 코드로 소프트웨어 아키텍처 다이어그램을 그릴 수 있는 C4 모델 매크로 라이브러리입니다.
mingrammer/diagrams
코드로 그리는 다이어그램: Python으로 클라우드 및 시스템 아키텍처 다이어그램을 만들고 AWS, Azure, GCP, Kubernetes 등의 아이콘을 사용하세요.
대체할 수 있는 제품:Lucidchart
Microsoft Visio
- 스타
- 42,752
- 포크
- 2,733
- 열린 이슈
- 400
- 마지막 커밋
- 5일 전
어떤 프로젝트인가요?
Diagrams는 클라우드 시스템 아키텍처 다이어그램을 코드로 그릴 수 있는 Python 라이브러리입니다. 디자인 도구에서 도형을 끌어다 놓는 대신, Python 스크립트에서 노드와 노드 간 연결을 정의하면 라이브러리가 Graphviz로 결과물을 렌더링합니다. 다이어그램이 일반 코드로 작성되므로 어떤 버전 관리 시스템으로든 버전 관리할 수 있고, 다이어그램이 설명하는 인프라와 함께 수정할 수 있습니다.
이 라이브러리에는 AWS, Azure, Google Cloud, Kubernetes, Alibaba Cloud, Oracle Cloud 등 주요 클라우드 제공업체의 아이콘 세트와 온프레미스 시스템, SaaS 제품, 프로그래밍 프레임워크, C4 모델 요소용 노드가 포함되어 있습니다. 새로운 아키텍처의 프로토타입을 만들거나 기존 아키텍처를 문서화하는 데 적합합니다. 실제 클라우드 리소스에 연결하거나 이를 관리하지 않으며, CloudFormation이나 Terraform 코드도 생성하지 않습니다.
온라인 플레이그라운드를 사용하면 Python이나 Graphviz를 설치하지 않고도 브라우저에서 라이브러리를 사용해 볼 수 있습니다.
핵심 기능
- 01git으로 버전 관리할 수 있는 Python 코드로 아키텍처 다이어그램을 정의합니다.
- 02AWS, Azure, GCP, Kubernetes, Alibaba Cloud, Oracle Cloud 등의 아이콘 세트를 제공합니다.
- 03온프레미스, SaaS, 프로그래밍, C4 노드 유형을 지원합니다.
- 04Graphviz를 통해 결과물을 렌더링합니다.
- 05브라우저에서 실행되는 온라인 플레이그라운드를 제공합니다.
활용 사례
- 구현에 앞서 새로운 클라우드 시스템 아키텍처의 프로토타입을 만듭니다.
- 코드와 함께 관리하는 다이어그램으로 기존 클라우드 또는 Kubernetes 배포를 문서화합니다.
- 문서화 파이프라인에서 아키텍처 다이어그램을 생성합니다.
빠른 시작
- 1
Graphviz 설치(macOS에서는 Homebrew 사용)
brew install graphviz - 2
pip으로 diagrams 패키지 설치
pip install diagrams
사용 전 알아둘 점
- 다이어그램을 렌더링하려면 Graphviz를 별도로 설치해야 합니다.
- Python 3.9 이상이 필요합니다.
- 클라우드 리소스를 제어하거나 Terraform 또는 CloudFormation 코드를 생성하지 않습니다. 다이어그램만 그립니다.
토픽
자주 묻는 질문
- diagrams은(는) 무엇인가요?
- 코드로 그리는 다이어그램: 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
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
일반 텍스트 설명으로 시퀀스, 클래스, 액티비티, 상태, Gantt 등 UML 및 다양한 다이어그램을 생성합니다.
React와 cytoscape.js로 일반 텍스트 개요를 플로차트와 다이어그램으로 변환하는 웹앱입니다.
AI 코딩 도구가 프로젝트 구조와 제약, 변경 범위를 HTML 맵으로 그린 뒤 확인을 기다리게 하는 에이전트 스킬입니다.
자연어와 Terraform, Kubernetes, SQL, OpenAPI 같은 실제 시스템 소스를 편집 가능한 draw.io 아키텍처 다이어그램으로 변환하는 에이전트 스킬입니다.
C4 기반 표기법으로 코드 기반 소프트웨어 아키텍처 다이어그램을 생성하는 모델링 언어와 도구 체인