Biblioteca de macros del modelo C4 para PlantUML que permite crear diagramas de arquitectura de software con código de texto plano.
mingrammer/diagrams
Diagramas como código: crea diagramas de arquitecturas de sistemas y de la nube escribiendo Python, con iconos de AWS, Azure, GCP, Kubernetes y más.
Alternativa open source a:Lucidchart
Microsoft Visio
- Estrellas
- 42,752
- Forks
- 2,733
- Issues abiertos
- 400
- Último commit
- hace 5 días
¿Qué es?
Diagrams es una biblioteca de Python para crear diagramas de arquitecturas de sistemas en la nube como código. En lugar de arrastrar formas en una herramienta de diseño, describes los nodos y las conexiones entre ellos en un script de Python, y la biblioteca genera el resultado con Graphviz. Como el diagrama es código sin formato, puedes guardarlo en cualquier sistema de control de versiones y modificarlo junto con la infraestructura que describe.
La biblioteca incluye conjuntos de iconos de los principales proveedores de servicios en la nube, como AWS, Azure, Google Cloud, Kubernetes, Alibaba Cloud y Oracle Cloud, además de nodos para sistemas locales, productos SaaS, frameworks de programación y elementos del modelo C4. Está pensada para crear prototipos de nuevas arquitecturas o documentar las existentes. No se conecta a recursos reales de la nube ni los administra, y tampoco genera código de CloudFormation o Terraform.
Un entorno de pruebas en línea te permite probar la biblioteca en el navegador sin instalar Python ni Graphviz.
Funciones clave
- 01Define diagramas de arquitectura como código Python que puedes versionar con git.
- 02Incluye conjuntos de iconos de AWS, Azure, GCP, Kubernetes, Alibaba Cloud, Oracle Cloud y más.
- 03Admite tipos de nodos para sistemas locales, SaaS, programación y C4.
- 04Genera el resultado mediante Graphviz.
- 05Ofrece un entorno de pruebas en línea que funciona en el navegador.
Casos de uso
- Crear prototipos de una nueva arquitectura de sistemas en la nube antes de implementarla.
- Documentar una implementación existente en la nube o Kubernetes mediante diagramas que se mantienen junto al código.
- Generar diagramas de arquitectura en flujos de documentación.
Inicio rápido
- 1
Instala Graphviz (en macOS, mediante Homebrew)
brew install graphviz - 2
Instala el paquete diagrams con pip
pip install diagrams
Antes de usarlo
- Es necesario instalar Graphviz por separado para poder generar los diagramas.
- Requiere Python 3.9 o posterior.
- No controla recursos en la nube ni genera código de Terraform o CloudFormation; solo dibuja diagramas.
Temas
Preguntas frecuentes
- ¿Qué es diagrams?
- Diagramas como código: crea diagramas de arquitecturas de sistemas y de la nube escribiendo Python, con iconos de AWS, Azure, GCP, Kubernetes y más. Diagrams es una biblioteca de Python para crear diagramas de arquitecturas de sistemas en la nube como código. En lugar de arrastrar formas en una herramienta de diseño, describes los nodos y las conexiones entre ellos en un script de Python, y la biblioteca genera el resultado con Graphviz. Como el diagrama es código sin formato, puedes guardarlo en cualquier sistema de control de versiones y modificarlo junto con la infraestructura que describe.
- ¿diagrams es gratuito? ¿Qué licencia tiene?
- diagrams es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿diagrams sigue mantenido?
- Mantenimiento activo. El último commit de diagrams fue el 17 oct 2026.
- ¿Para qué puedo usar diagrams?
- Crear prototipos de una nueva arquitectura de sistemas en la nube antes de implementarla. Documentar una implementación existente en la nube o Kubernetes mediante diagramas que se mantienen junto al código. Generar diagramas de arquitectura en flujos de documentación.
- ¿Cómo se instala diagrams?
- Instala Graphviz (en macOS, mediante Homebrew): brew install graphviz Instala el paquete diagrams con pip: pip install diagrams
- ¿Dónde consigo diagrams?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mingrammer/diagrams
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Genera diagramas UML y de otros tipos a partir de descripciones en texto, como diagramas de secuencia, clases, actividades, estados y Gantt.
Una aplicación web que convierte esquemas de texto sin formato en diagramas y diagramas de flujo, creada con React y cytoscape.js.
Una skill para que las herramientas de programación con IA representen la arquitectura, las restricciones y el alcance de los cambios del proyecto en un mapa HTML, y esperen la confirmación antes de editar código.
Una skill para agentes que convierte lenguaje natural y fuentes reales del sistema, como Terraform, Kubernetes, SQL y OpenAPI, en diagramas de arquitectura editables en draw.io.
Lenguaje de modelado y conjunto de herramientas que genera diagramas de arquitectura de software basados en código y actualizados en tiempo real, con notación inspirada en C4.