Uma biblioteca de macros do modelo C4 para PlantUML que permite criar diagramas de arquitetura de software usando código em texto puro.
mingrammer/diagrams
Diagrama como código: crie diagramas de arquitetura de nuvem e sistemas com Python, usando ícones de AWS, Azure, GCP, Kubernetes e muito mais.
Alternativa open source a:Lucidchart
Microsoft Visio
- Estrelas
- 42,752
- Forks
- 2,733
- Issues abertas
- 400
- Último commit
- há 5 dias
O que é?
Diagrams é uma biblioteca Python para criar diagramas de arquitetura de sistemas em nuvem como código. Em vez de arrastar formas em uma ferramenta de design, você descreve os nós e as conexões entre eles em um script Python, e a biblioteca renderiza o resultado com Graphviz. Como o diagrama é código puro, ele pode ser versionado em qualquer sistema de controle de versão e atualizado junto com a infraestrutura que representa.
A biblioteca inclui conjuntos de ícones dos principais provedores de nuvem, como AWS, Azure, Google Cloud, Kubernetes, Alibaba Cloud e Oracle Cloud, além de nós para sistemas on-premises, produtos SaaS, frameworks de programação e elementos do modelo C4. Ela é voltada à prototipagem de novas arquiteturas ou à documentação das já existentes. Não se conecta a recursos reais de nuvem nem os gerencia, e não gera código de CloudFormation ou Terraform.
Um playground online permite testar a biblioteca no navegador sem instalar Python ou Graphviz.
Recursos principais
- 01Defina diagramas de arquitetura como código Python, que pode ser versionado com git.
- 02Inclui conjuntos de ícones para AWS, Azure, GCP, Kubernetes, Alibaba Cloud, Oracle Cloud e muito mais.
- 03Oferece suporte a tipos de nós para on-premises, SaaS, programação e C4.
- 04Renderiza a saída usando Graphviz.
- 05Disponibiliza um playground online que funciona no navegador.
Casos de uso
- Prototipar uma nova arquitetura de sistemas em nuvem antes da implementação.
- Documentar uma implantação existente de nuvem ou Kubernetes com diagramas mantidos junto com o código.
- Gerar diagramas de arquitetura em pipelines de documentação.
Início rápido
- 1
Instale o Graphviz (no macOS, usando o Homebrew)
brew install graphviz - 2
Instale o pacote diagrams com pip
pip install diagrams
Antes de usar
- É necessário instalar o Graphviz separadamente para renderizar diagramas.
- Requer Python 3.9 ou superior.
- Não controla recursos na nuvem nem gera código de Terraform ou CloudFormation; apenas desenha diagramas.
Tópicos
Perguntas frequentes
- O que é diagrams?
- Diagrama como código: crie diagramas de arquitetura de nuvem e sistemas com Python, usando ícones de AWS, Azure, GCP, Kubernetes e muito mais. Diagrams é uma biblioteca Python para criar diagramas de arquitetura de sistemas em nuvem como código. Em vez de arrastar formas em uma ferramenta de design, você descreve os nós e as conexões entre eles em um script Python, e a biblioteca renderiza o resultado com Graphviz. Como o diagrama é código puro, ele pode ser versionado em qualquer sistema de controle de versão e atualizado junto com a infraestrutura que representa.
- diagrams é gratuito? Qual é a licença?
- diagrams é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- diagrams ainda é mantido?
- Manutenção ativa. O último commit de diagrams foi em 17 de out. de 2026.
- Para que posso usar diagrams?
- Prototipar uma nova arquitetura de sistemas em nuvem antes da implementação. Documentar uma implantação existente de nuvem ou Kubernetes com diagramas mantidos junto com o código. Gerar diagramas de arquitetura em pipelines de documentação.
- Como instalar diagrams?
- Instale o Graphviz (no macOS, usando o Homebrew): brew install graphviz Instale o pacote diagrams com pip: pip install diagrams
- Onde consigo diagrams?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mingrammer/diagrams
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Gera diagramas UML e outros a partir de descrições em texto simples, incluindo diagramas de sequência, classes, atividades, estados, Gantt e muito mais.
Um app web que transforma esboços em texto simples em fluxogramas e diagramas, desenvolvido com React e cytoscape.js.
Uma skill que faz ferramentas de programação com IA desenharem a arquitetura, as restrições e o escopo das mudanças do projeto em um mapa HTML, aguardando confirmação antes de editar o código.
Uma skill de agente que transforma linguagem natural e fontes reais do sistema, como Terraform, Kubernetes, SQL e OpenAPI, em diagramas de arquitetura editáveis no draw.io.
Linguagem de modelagem e conjunto de ferramentas que gera diagramas de arquitetura de software baseados em código e atualizados em tempo real, com notação inspirada no C4.