Библиотека макросов модели C4 для PlantUML, позволяющая описывать диаграммы архитектуры ПО обычным текстом.
mingrammer/diagrams
Диаграммы как код: создавайте схемы облачных и системных архитектур на Python с иконками AWS, Azure, GCP, Kubernetes и других платформ.
Open source альтернатива:Lucidchart
Microsoft Visio
- Звёзды
- 42,752
- Форки
- 2,733
- Открытые issues
- 400
- Последний коммит
- 5 дней назад
Что это?
Diagrams — это библиотека Python для создания схем облачных системных архитектур в виде кода. Вместо того чтобы перетаскивать фигуры в графическом редакторе, вы описываете узлы и связи между ними в скрипте Python, а библиотека отображает результат с помощью Graphviz. Поскольку схема представляет собой обычный код, её можно хранить в системе контроля версий и изменять вместе с описываемой ею инфраструктурой.
В библиотеку входят наборы иконок основных облачных платформ, в том числе AWS, Azure, Google Cloud, Kubernetes, Alibaba Cloud и Oracle Cloud, а также узлы для локальных систем, SaaS-продуктов, программных фреймворков и элементов модели C4. Библиотека предназначена для прототипирования новых архитектур и документирования существующих. Она не подключается к реальным облачным ресурсам и не управляет ими, а также не генерирует код CloudFormation или Terraform.
В онлайн-песочнице можно попробовать библиотеку в браузере без установки Python и Graphviz.
Ключевые возможности
- 01Описывайте архитектурные схемы на Python и храните их в git.
- 02Включает наборы иконок AWS, Azure, GCP, Kubernetes, Alibaba Cloud, Oracle Cloud и других платформ.
- 03Поддерживает типы узлов для локальных систем, SaaS, программирования и C4.
- 04Отображает результат с помощью Graphviz.
- 05Предлагает онлайн-песочницу, работающую в браузере.
Сценарии использования
- Прототипирование новой архитектуры облачной системы до начала реализации.
- Документирование существующего облачного развёртывания или развёртывания Kubernetes с помощью схем, хранящихся рядом с кодом.
- Создание архитектурных схем в конвейерах документации.
Быстрый старт
- 1
Установите Graphviz (в macOS — с помощью Homebrew)
brew install graphviz - 2
Установите пакет diagrams с помощью pip
pip install diagrams
Что важно знать
- Для отрисовки диаграмм необходимо предварительно установить Graphviz отдельно.
- Требуется Python 3.9 или выше.
- Инструмент не управляет облачными ресурсами и не генерирует код Terraform или CloudFormation — он только рисует диаграммы.
Темы
Частые вопросы
- Что такое diagrams?
- Диаграммы как код: создавайте схемы облачных и системных архитектур на Python с иконками AWS, Azure, GCP, Kubernetes и других платформ. Diagrams — это библиотека Python для создания схем облачных системных архитектур в виде кода. Вместо того чтобы перетаскивать фигуры в графическом редакторе, вы описываете узлы и связи между ними в скрипте Python, а библиотека отображает результат с помощью Graphviz. Поскольку схема представляет собой обычный код, её можно хранить в системе контроля версий и изменять вместе с описываемой ею инфраструктурой.
- diagrams можно использовать бесплатно? Какая у него лицензия?
- diagrams распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- diagrams всё ещё поддерживается?
- Активно поддерживается. Последний коммит в diagrams — 17 окт. 2026 г..
- Для чего можно использовать diagrams?
- Прототипирование новой архитектуры облачной системы до начала реализации. Документирование существующего облачного развёртывания или развёртывания Kubernetes с помощью схем, хранящихся рядом с кодом. Создание архитектурных схем в конвейерах документации.
- Как установить diagrams?
- Установите Graphviz (в macOS — с помощью Homebrew): brew install graphviz Установите пакет diagrams с помощью pip: pip install diagrams
- Где скачать diagrams?
- Исходный код и инструкции по установке — на GitHub: https://github.com/mingrammer/diagrams
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Создаёт UML-диаграммы и другие схемы по текстовым описаниям: диаграммы последовательностей, классов, активностей, состояний, Ганта и не только.
Веб-приложение на React и cytoscape.js, которое превращает текстовые планы в виде иерархического списка в блок-схемы и диаграммы.
Навык для AI-инструментов разработки: строит HTML-карту архитектуры, ограничений и границ изменений проекта и ждёт подтверждения перед редактированием кода.
Навык для агентов, который превращает запросы на естественном языке и реальные источники вроде Terraform, Kubernetes, SQL и OpenAPI в редактируемые архитектурные диаграммы draw.io.
Язык моделирования и набор инструментов для создания актуальных диаграмм архитектуры ПО по коду с нотацией на основе C4.